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ASSTRACT 

The  specialized  device  interfaces  for  the  University  of  Maryland 
Computer  Vision  Laboratory  image  acquisition  and  display  equip 
ment  extend  the  capabilities  of  a  PDP-11/45  hosting  the  UNIX 
operating  system.  The  devices  include  the  Grinnell  GMR-27  co. or 
display  processor,  the  other  Computer  Vision  Laboratory  display 
and  scanning  equipment,  and  the  Digi-Data  TM-il/TU-16  compatible 
tape  drive.  Subroutine  packages  give  easy  access  to  the  in  ,er 
faces  from  user  programs,  allowing  full  use  of  the  special 
features.  Programs  using  these  subroutine  packages  and  the 
well-designed  UNIX  operating  system  provide  a  flexible  and  power¬ 
ful  environment  for  image  processing  and  program  development. 
Short  descriptions  of  these  interfaces,  subroutines,  and  programs 
are  given  for  program  writers  and  other  users. 
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I.  INTRODUCTION 


The  specialized  device  interfaces  for  the  University  of  Maryland 
Computer  Vision  Laboratory  image  acquisition  and  display  equip¬ 
ment  extend  the  capabilities  of  a  PDP-11/45  hosting  -the  UNIX 
operating  system.  The  devices  include  the  Grinnell  GMR-27  color 
display  processor/  the  other  Computer  Vision  Laboratory  display 
and  scanning  equipment/  and  the  Digi-Data  TM-ll/TU-16  compatible 
tape  drive.  Subroutine  packages  give  easy  access  to  the  inter¬ 
faces  from  user  programs/  allowing  full  use  of  the  special 
features.  Programs  using  these  subroutine  packages  and  the 
well-designed  UNIX  operating  system  provide  a  flexible  and  power¬ 
ful  environment  for  image  processing  and  program  development. 
Short  descriptions  of  these  interfaces/  subroutines/  and  programs 
are  given  for  program  writers  and  other  users. 

This  document  has  been  produced  with  the  UNIX  "nroff"  text  pro¬ 
cessor  so  that  it  may  be  more  easily  updated.  It  consists  of 
short  descriptions  in  a  format  approx imating  that  of  the  manual 
sections  that  are  provided  in  the  UNIX  operating  system  user 
manual.  References  made  by  capital  roman  numerals  in  parentheses 
refer  to  sections  within  that  manual.  However/  the  normal  order¬ 
ing  and  grouping  of  these  sections  has  been  altered  for  the 
current  presentation  into  interfaces,  subroutines/  and  programs. 

These  descriptions  are  intended  as  cursory  reference  material  for 
those  who  are  actively  using  the  system  at  the  University  of 
Maryland  Computer  Vision  Laboratory.  Tutorial  and  in-depth 
descriptions  of  the  UNIX  operating  system  are  available  else¬ 
where.  Furthermore,  these  descriptions  represent  only  an  approx¬ 
imation  to  the  actual  behavior.  Programs  may  change  or  bugs  may 
exist.  These  descriptions  are  guidelines  at  besti  more  accurate 
versions  may  be  found  on-line. 

The  older  display  equipment  is  connected  to  the  CPU  through  a 
DR-11B  direct  memory  access  (DMA)  interface.  Under  CPU  control, 
it  can  produce  high-quality,  hard-copy  6  bit  images  on  Polaroid 
film.  film  strips,  or  slides,  and  can  display  images  on  a  black- 
and-white  monitor. 

The  newer  Grinnell  GMR-27  color  display  processor  also  operates 
through  a  DR-11B  DMA  interface.  The  system  includes  the  display 
processor  and  memory,  a  track  ball  and  switches,  color  monitors, 
and  a  black-and-white  TV  camera.  The  memory  consists  of  a  512  by 
512  array  of  13  bit  pixels.  12  bits  can  display  4  bits  of  each 
of  the  three  colors:  blue,  green,  and  red.  The  13th  bit  displays 
as  a  white  overlay.  The  high  order  9  bits  of  the  12  color 
display  bits  can  also  be  displayed  as  b lac k -and-wh i te-onl y  grays¬ 
cale  images.  When  using  the  TV  camera,  only  the  bottom  4S0  rows 
are  actually  displayed  and  only  6  bits  of  grayscale  may  be  ac¬ 
quired  from  any  one  frame.  However,  frame  averaging  can  produce 
additional  bits  of  input  accuracy.  A  read/write.  rand om-ac c ess. 
4096  entry  table  in  the  display  processor  can  display  any  12  bit 
number  in  the  memory  as  any  other  12  bit  number  without  altering 
the  memory  contents.  The  display  processor  also  supports  cursor 
positioning.  cursor  readback.  memory  readback  memory  writing. 


alphanumeric  graphics/  vector  graphics/  and  internal  test  pat¬ 
terns.  Channel  and  subchannel  masks  allow  only  selected  bits  of 
each  pixel  to  be  either  read  or  altered. 

The  tape  driver  has  been  extended  to  correct  some  of  the  long¬ 
standing  and  well-known  deficiencies  of  the  original  UNIX  operat¬ 
ing  system.  A  description  of  this  extended  tape  driver  is  in¬ 
cluded  since  such  a  large  portion  of  image  processing  in  this 
system  seems  to  involve  tape  handling. 

Subroutines  provide  a  more  convenient  programmer  interface  to  the 
hardware  capab  i  1 i t ies.  The  CXAP  subroutine  package  provides  a 
C-language  callable  interface  that  is  similar  to  the  FORTRAN 
callable  XAP  package  originally  written  for  the  UNIVAC  1100 
series  machines.  The  Grinnell  Application  Package  (GAP)  allows  a 
complete  C-callable  interface  to  the  Grinnell  processor.  Other 
subroutines  have  also  been  written  for  specialized  image  process¬ 
ing  uses.  Using  these  subroutines/  students  without  previous  ex¬ 
perience  in  either  the  C  language  or  the  UNIX  operating  system 
have  rapidly  written  C  programs  to  perform  image  processing. 
Descriptions  of  some  of  these  programs  have  been  included.  Some 
utility  programs  are  also  described  so  that  the  novice  user/ 
after  logging  onto  the  system/  may  easily  evoke  the  available  im¬ 
age  processing  and  graphics  routines.  Finally/  a  section 
describes  some  quadtree  manipulation  programs  that  use  the  Grin¬ 
nell  processor. 

The  section  dividers  within  this  manual  were  produced  using  some 
of  the  described  capab i 1 i ti es. 
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NAME 

dr  -  DRll-B  Direct  Memory  Access  Device 


DESCRIPTION 

This  fils  refers  to  the  DRll-B  es  used  at  the  Computer  Vi¬ 
sion  Laboratory  of  the  University  of  Maryland. 

The  rdrO  (or  drO  )  file  is  used  to  output  pictorial  informa¬ 
tion  to  the  scan  conversion  memory  for  display  purposes. 

Explanation  on  how  to  set  up  the  device  to  receive  image 
data  from  the  PDP11/49  is  beyond  the  scope  of  this  descrip¬ 
tion  and  should  be  sought  from  someone  familiar  with  the 
procedure. 


When  the  file  is  opened*  a  RESET  command  is  sent  to  the  dev¬ 
ice.  Upon  closing  of  the  file*  a  DISPLAY  command  will  be 
sent. 


This  being  a  disc lau  device*  the  user  is  restricted  to  only 
writing  on  the  file.  Seeking  in  the  forward  direction  is 
totally  ignored.  Seeking  in  the  reverse  direction  causes  a 
RESET  command  to  be  sent  to  the  device  (Thus  resetting  the 
device  counters  and  disabling  the  scanner  until  the  RESET 
button  on  the  device  itself  is  pushed). 

Caution  must  be  taken  to  set  up  the  device  switches  them¬ 
selves  correctly.  If  they  are  incorrect,  in  some  situations 
the  call  on  the  device  will  sleep  with  an  un'kill'able 
priority  until  they  are  correct*  thus  causing  untold  frus¬ 
tration  and  anxiety. 

To  use  the  scanner  correctly*  each  pixel  should  be  left  jus¬ 
tified  in  the  byte  written  out.  (For  example*  a  64-greylev- 
el  picture  should  have  each  pixel's  value  shifted  left  2 
bits  (multiplied  by  4).  ) 

About  four  seconds  after  no  data  has  been  sent  to  the 
scanner*  it  will  display  what  has  been  sent.  This  does  not 
disable  the  scanner  from  receiving  more  data  from  your  pro¬ 
gram.  It  is  only  a  convenience  feature  with  no  side  effects. 


FILES 

/dev/rdrO*  /dev/drO 


BUGS 


The  switches  for  the  number  of  columns  on  the  scan  device 
must  be  set  to  one  less  than  the  actual  number  of  columns 
sent  from  the  PDPll/45.  The  picture  will  still  all  come 
out.  Care  must  be  taken  to  write  out  your  picture  to  the 
scanner  in  even  sized  chunks*  odd  byte  counts  causing  an  im¬ 
mediate  system  error.  This  means,  of  course,  that  it  is  im¬ 
possible  to  send  out  an  image  that  has  an  odd  number  of  rows 
and  an  odd  number  of  columns. 
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OR ( I V ) 


NAME 

gr  -  DR -11  intjrfscs  to  Grmneil  display  processor  OMR -27 
DE3CR IP7ICN 

Or.  refers  to  the  modified  DR-11B  interface  to  the  Grinnell 
display  processor,  GMR-27.  The  interface  supports  both  syn¬ 
chronous  and  asynchronous  I/O  as  a  character  device  only. 
Synchronous  requests  are  satisfied  in  a  limited  time  Asyn¬ 
chronous  requests  may  be  delayed  until  some  external  condi¬ 
tion  is  satified,  such  as  the  CURSOR  ENTER  button  being 
pressed.  In  synchronous  I/O,  the  buffer  mus  t  begin  on  a 
word  boundary  and  the  count  mus  t  be  even.  Seek  calls  for 
the  file  q_r  are  meaningless. 

Each  word  written  to  the  file  qr.  commands  the  GMR-27  to  pei 
form  one  operation  (except  when  using  packed  bytes).  Each 
write  is  done  as  a  single  DMA  transfer. 

The  interface  performs  synchronous  reading  in  a  non— standard 
manner.  The  buffer  used  to  synchronously  read  words  from 
the  GMR-27  must  begin  with  command  words  which  are  first 
sent  to  the  GMR-27  to  enable  reading.  The  last  of  these 
command  words  must  be  readback  peripheral  data  (RPD), 
0160000  (octal).  All  words  following  the  first  RPD  in  the 
buffer  receive  data  words  from  the  GMR-27.  If  no  RPD  com¬ 
mand  resides  in  the  buffer  or  the  first  RPD  is  the  last  word 
in  the  buffer,  read  returns  an  error  condition  without  send¬ 
ing  any  commands  to  the  GMR-27.  The  byte  count  returned 
from  a  synchronous  read  includes  the  initial  command  words 
which  were  written  to  the  GMR-27.  In  order  to  protect  UNIX 
from  being  stalled  by  an  improperly  programmed  synchronous 
read  command  performing  asynchronous  I/O  or  using  non¬ 
existent  GMR-27  peripheral  devices,  the  interface  limits  the 
duration  of  synchronous  reading  If  the  GMR-27  does  not 

complete  a  synchronous  read  request  promptly,  the  interface 
interrupts  the  DMA  transfer  and  returns  a  shortened  read 
byte  count.  3uch  an  incomplete  read  count  should  be  con¬ 
sidered  as  an  error.  To  avoid  unnec e s sar  1 1  y  tying  up  UNIX, 
processes  should  not  use  synchronous  read  calls  which  may 
need  to  be  interrupted. 

x  Processes  may  also  wait  for  asynchronous  events  by  reading 

with  a  byte  count  of  exactly  two.  In  order  to  intercept 
GMR-27  asynchronous  events,  the  interface  enables  the  GMR-27 
"interrupt"  peripheral  device  with  a  select  peripheral  dev¬ 
ice  ( SPD ) ,  0122C00  (octal),  issues  an  RPD  command,  and  re- 

auests  a  data  word  transfer  from  the  GMR— 27.  Waiting  for  an 

asynchronous  event,  the  GMR— 27  delays  returning  a  data  word 
until  a  user  either  presses  the  enter  button  or  moves  the 
trackball  with  the  -rack  switch  on.  Between  synchronous  I/O 
requests,  until  the  interface  receives  an  "interrupt"  word, 
the  interface  waits  in  a  background  mode  for  an  asynchronous 
event.  After  an  asynchronous  event,  all  waiting  processes 
receive  the  " :  nterrup  t"  word.  After  an  asynchronous  event.- 
synchronous  reads  can  elicit  the  cause  of  the  event  ana 
reset  the  interrupt  -lags  within  the  GMR-27. 
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Since  multiple  opens  are  permitted/  the  state  of  the  GMR-27 
may  unexpectedly  change  between  the  I/O  requests  of  any  one 
process.  Also,  the  background  asynchronous  I/O  processing 
may  alter  the  selection  of  peripheral  devices  with  an  SPD 
after  each  synchronous  I/O  request.  Thus,  each  I/O  request 
is  responsible  for  reestablishing  the  volatile  state  of  the 
GMR-27  whenever  simultaneous  operations  could  occur.  Some 
volatile  elements  of  the  GMR-27  state  which  may  need  to  be 
reset  include: 

1)  Display  channel  (LDC)  and  subchannel  mask  (LSM) 
selection. 

2)  Write  <LWM)  and  update  (LUM)  modes. 

3)  Element  (LER.  LEA.  LEB.  and  LEC)  and  line  (LLR. 
LLA.  LLB.  and  LLC )  registers,  and 

4)  Selection  (SPD)  and  use  (LPR.  LPA,  and  LPD)  of 
some  GMR-27  peripherals. 

The  volatile  GMR-27  peripheral  devices  include: 

1)  Memory  readback. 

2)  Independent  cursor  locations  and  flags,  and 

3)  Byte  unpacking. 

To  avoid  interference  with  other  I/O,  byte  unpacking  should 
be  completed  by  single  I/O  transfers. 

Other  GMR-27  peripheral  devices  which  have  global  effects 
are  manipulated  less  often.  Since  all  users  should  agree  to 
their  invocation,  these  devices  and  commands  need  not  be 
reset  or  reissued  with  each  I/O  request: 

1)  Graphic  digitizer  (camera  input), 

2)  Video  control  (color  vs  grayscale), 

3)  Video  lookup  table. 

4)  Internal  self-tests, 

5)  Screen  and  line  erasure,  and 

6)  Scrol 1 ing. 

With  simultaneous  users,  by  convention,  each  user  should  in¬ 
sure  that  only  allocated  GMR-27  display  memory  is  altered. 
Mutual  user  consent  should  be  obtained  before  changing  glo¬ 
bal  GMR-27  states. 


FILES 

/dev/gr 

SEE  ALSO 

grdef s (VII) 

Grinnell  Systems,  GMR-27  User  ' s  Manual . 

BUGS 

The  DR-118  interface  hardware  must  be  modified  so  that 
stalled  DMA  transfers  may  be  safely  terminated.  This  modif¬ 
ication,  which  connects  one  of  the  unassigned  function  bits 
to  ATTN,  must  be  made  before  reading  is  attempted. 

The  driver  could  establish  a  starting  image  position  before 
each  transfer  (in  GMR-27  registers  Ec  and  Lc  perhaps'. 
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NAME 

grdePs  -  Grinnell  display  processor  GMR-27  dePinitions 
SYNOPSIS 

#i nc 1 ud e  /usr/lib/grdePs.  c 
#inc 1 ud e  /usr/lib/grdePs.  P 
DESCRIPTION 

The  Pile  ordePs  provides  command  mnemonic  dePinitions  Por 
the  Grinnell  display  processor  GMR-27  as  implemented  at  the 
University  oP  Maryland. 

Mnemonics  speciPy  each  GMR-27  command  and  bit  patterns  used 
to  evoke  options  within  each  command.  Command  sequences  Por 
each  peripheral  summarize  the  available  peripheral  device 
Peatures.  The  Pormat  oP  data  words  supplied  by  the  readback 
peripheral  data  (RPD)  command  is  provided  aPter  the  RPD  com¬ 
mand  of  appropriate  peripheral  devices.  A  standard  header 
gives  the  needed  Pormat  Por  raster  outputting  rectangular 
images. 

In  the  Poliowing  summary*  A's  and  D's  represent  addresses 
and  data*  respectively.  CL  is  used  to  speciPy  a  cursor 
coordinate  name  Por  the  independent  cursor  peripheral  dev¬ 
ice.  In  CL*  C  is  0  or  1  to  speciPy  the  Pirst  or  second  cur¬ 
sor  (only  two  out  oP  Pour  may  be  man  ip ulated ) .  L  is  0  or  1 
to  speciPy  an  element  (column)  or  line  (row)  coordinate* 
respectively. 

FILES 

/usr / 1 i b /grdePs. c  Por  c 

/usr/1 ib/grdefs. P  Por  Fortran 

SEE  ALSO 

Grinnell  Systems.  GMR-27  User's  Manua 1 . 
gr(IV) 

AUTHOR 

Robert  L.  Kirby 

BUGS 


Other  definition  Piles  are  also  in  use. 


GRDEFS(VII)  5-uctober-1979  GRDEFS(VII) 


COMMAND  SUMMARY 

Value  Mnemonic  Value  Name 

(octal)  (bit) 


OOdddd 

MID 

0 

000 

DDD 

DDD 

DDD 

Olmmmm 

LSM 

0 

001 

MMM 

MMM 

MMM 

020ddd 

WGD 

0 

010 

00  x 

xDD 

DDD 

022ddd 

WAC 

0 

010 

01  x 

xOD 

DDD 

0240mm 

LWM 

0 

010 

lOx 

x  BA 

ZVH 

000200 

LIGHT 

0 

000 

000 

010 

000 

000100 

ADD I TV 

0 

000 

000 

001 

000 

000040 

ZEROW 

0 

000 

000 

000 

100 

000020 

VECTOR 

0 

000 

000 

000 

010 

000010 

DHGHT 

0 

000 

000 

000 

001 

000004 

DWDTH 

0 

000 

000 

000 

000 

000002 

CURPOS 

0 

000 

000 

000 

000 

000001 

VCURSOR 

0 

000 

000 

000 

000 

0260mm 

LUM 

0 

010 

llx 

XXX 

SSL 

000001 

EC 

0 

000 

000 

000 

000 

000002 

EDA 

0 

000 

000 

000 

000 

000003 

EC  A 

0 

000 

000 

000 

000 

000004 

LC 

0 

000 

000 

000 

000 

000010 

LBA 

0 

000 

000 

000 

001 

000014 

LCA 

0 

000 

000 

000 

001 

000020 

SHOME 

0 

000 

000 

000 

010 

000040 

SDOWN 

0 

000 

000 

000 

100 

000060 

SUP 

0 

000 

000 

000 

1 10 

030000 

ERS 

0 

on 

00  x 

XXX 

XXX 

032000 

ERL 

0 

on 

01  x 

XXX 

XXX 

0341mm 

SLU 

0 

on 

lOx 

X  X  I 

SSL 

000100 

SINHBT 

0 

000 

000 

001 

000 

036000 

EGW 

0 

on 

llx 

XXX 

XXX 

002000 

GWRITE 

0 

000 

010 

000 

000 

040aaa 

LER 

0 

100 

OWx 

AAA 

AAA 

044aaa 

LEA 

0 

100 

lWx 

AAA 

AAA 

050aaa 

LEB 

0 

101 

OWx 

AAA 

AAA 

054aaa 

LEC 

0 

101 

lWx 

AAA 

AAA 

060aaa 

LLR 

0 

1 10 

OWx 

AAA 

AAA 

064aaa 

LLA 

0 

110 

lWx 

AAA 

AAA 

070aaa 

LLS 

0 

111 

OWx 

AAA 

AAA 

074aaa 

LLC 

0 

1 1 1 

lWx 

AAA 

AAA 

DDD 

Wr  i 

be  Image  Data 

MMM 

Loa 

i  Subchannel 

Mask 

DDD 

Wr  i 

be  Graphic  Da 

ta 

(le 

ft  to  right  8 

bits) 

DDD 

Wr  i 

be  Alphanumer 

ic  Char- 

act 

er  (7-bit  ASC 

II  upper 

cas 

s  only) 

WCC 

Loa 

d  Write  Mode 

000 

Li  g 

It  background 

< re 

✓ersed  vs  dar 

k  ) 

000 

Add 

itive  graph  ic 

s 

000 

Zer 

o  Write  (must 

use ) 

000 

Vec 

tor  graphics 

000 

Dou 

ale  Height 

100 

Dou 

ale  Width 

010 

Sum 

for  cursor  p 

os i ti on 

001 

Vis 

i b  1  e  cursor 

LEE 

Loa 

i  Update  Mode 

001 

Ea 

=  Ec 

010 

Ea 

*  Ea  +  Eb 

Oil 

Ea 

*  Ea  +  Ec 

100 

La 

=  Lc 

000 

La 

=  La  +  Lb 

100 

La 

=  La  +  Lc 

000 

Horn 

3  scrol  1 

000 

scr 

all  down 

000 

scr 

all  up 

XXX 

Era 

se  (entire  sc 

r  een ) 

XXX 

Era 

se  Line 

LEE 

Sp  e 

cial  Location 

Update 

( se 

s  LUM  for  SSL 

LEE) 

000 

Inh 

ib i t  scrol 1  t 

iming 

XXX 

Exe 

cute  Graphic 

Write 

000 

Ex  e 

cute  graph  ic 

bit,  W 

wr  i 

te  after  load 

ing 

reg 

ister  in  foil 

owing 

AAA 

Loa 

d  Ea  Relative 

AAA 

Loa 

d  Ea 

AAA 

Loa 

d  Eb 

AAA 

Loa 

d  Ec 

AAA 

Loa 

d  La  Relative 

AAA 

Loa 

d  La 

AAA 

Loa 

d  Lb 

AAA 

Loa 

d  Lc 
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10000 c 

LDC 

1 

000 

XXX 

XXX 

XXX 

CCC 

Load  Display  Channels 

000003 

IMAGECH 

0 

000 

000 

000 

000 

on 

Image  display  channels 
bits(ll-8>  and  (7-0) 

000004 

OVERLAY 

0 

000 

000 

000 

000 

100 

Overlay  display  channel 
for  white  overlay 

110000 

NOP 

1 

001 

XXX 

XXX 

XXX 

XXX 

No  Operation 

12pppp 

SPD 

1 

010 

ppp 

ppp 

ppp 

ppp 

Select  Peripheral  Device 

13aaaa 

LPA 

1 

on 

AAA 

AAA 

AAA 

AAA 

Load  Peripheral  Address 

1 4dd  d  d 

LPR 

1 

100 

DDD 

DDD 

DDD 

DDD 

Load  Peripheral  Register 

1 5dddd 

LPD 

1 

101 

DDD 

DDD 

DDD 

DDD 

Load  Peripheral  Data 

160000 

RPD 

1 

1 10 

XXX 

XXX 

XXX 

XXX 

Readback  Peripheral  Data 

170000 

NON 

1 

111 

XXX 

XXX 

XXX 

XXX 

No  Operation 

PERIPHERAL 

DEVICE  ( 

ZONTROLS 

Camera 

i  Diaitizer  i 

control 

120002 

DIGITZ 

1 

010 

000 

000 

000 

010 

Select  Peripheral  Device 

1400  ip 

LPR 

1 

100 

000 

000 

IIO 

PPP 

II=camera  selection=00 
( PPP<8 ) =sh i f t  down  count 

1 5c  ddd 

LPD 

1 

101 

Cx  x 

xDD 

DDD 

DDD 

Camera  digitizing  mode 

004000 

CNTUOUS 

0 

000 

100 

000 

000 

000 

Continuous  input  with 

D>1  is  averaging  count, 
D=0  or  C=0  single  frame 

IndeDendent  Cursor 

control 

120004 

CURSOR 

1 

010 

000 

000 

000 

100 

Select  Peripheral  Device 

1 4000d 

LPR 

1 

100 

000 

000 

000 

ODD 

Display  cursors  (D=i=on) 
Each  bit  for  a  cursor 

1 4400d 

CUJHITE 

1 

100 

100 

000 

000 

ODD 

D=1  for  white,  D=0  black 

13000c 

LPA 

1 

on 

000 

000 

000 

OCL 

to  address  coordinate 
CL=selected  cursor  name 

1 50d  d  d 

LPD 

1 

101 

Ox  x 

DDD 

DDD 

DDD 

Move  cursor  relatively 

1 54d  d  d 

ABSMOV 

1 

101 

1  X  X 

DDD 

DDD 

DDD 

Move  cursor  absolutely 

160000 

RPD 

1 

110 

XXX 

XXX 

XXX 

XXX 

Read  cursor  positions 
Reading  line  resets  flag 

Of Caaa 

data 

0 

OOF 

OCL 

AAA 

AAA 

AAA 

F=1  if  enter  flag  is  on, 

CL=selected  cursor  name 

Use  read  count  of  2  to  wait  for  cursor  flag  events. 

Device  /dev/gr  uses  an  SPD( 122000)  and  RPD( 160000) 
to  obtain  the  following  data  word: 


000004 

data 

0 

000 

000 

000 

000 

100 

Cursor 

interrupt  word 

Sd  ec i a  1 

Video  Control 

120020 

VCNTRL 

1 

010 

000 

000 

010 

000 

Select 

Peripheral  Device 

14000g 

LPR 

1 

100 

000 

000 

000 

OOG 

G=1  greyscale  (bits  11-4) 

G=0  color  (blue  11-8, 
green  7-4,  red  3-0) 


Video  Lookup  table 


120040 

LOOKUP 

1 

010 

000 

000 

100 

000 

Select  Peripheral  Device 

1 3aaaa 

LPA 

1 

on 

AAA 

AAA 

AAA 

AAA 

Load  table  address 

15dddd 

LPD 

1 

101 

DDD 

DDD 

DDD 

DDD 

Put  data  in  table 

14000b 

LPR 

1 

100 

000 

000 

000 

OOB 

E=1  bypass  lookup  table 

160000 

RPD 

1 

1  10 

XXX 

XXX 

XXX 

XXX 

Readback  lookup  table 

lOdddd 

da  ta 

1 

000 

DDD 

DDD 

DDD 

DDD 

Lookup  table  value 

A 
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Memoru  Readbac k 


120400 

MEMORY 

1 

010 

000 

100 

000 

000 

Select  Peripheral  Device 

160000 

RPD 

1 

110 

XXX 

XXX 

XXX 

XXX 

Readback  memory  channel 

OOdddd 

data 

0 

000 

DDD 

DDD 

DDD 

DDD 

Selected  memory  value 

Bute 

UnDac  kina 

121000 

UNPACK 

1 

010 

001 

000 

000 

000 

Select  Peripheral  Device 

001000 

SWTBYT 

0 

000 

001 

000 

000 

000 

Switch  bytes  of  word 

EbaoWi 

SWTBYT  default 

i  s 

on  (for 

least 

significant  byte  first). 

000400 

ODDBYT 

0 

000 

000 

100 

000 

000 

Ignore  last  byte  of  last 

word  in  following  (Y  bit) 

141ddd 

I  BYTES 

1 

100 

Oxl 

YDD 

DDD 

DDD 

D=pairs  of  image  points 

1 45d  d  d 

GBYTES 

1 

100 

101 

YDD 

DDD 

DDD 

D=words  of  graphic  data 

147ddd 

ABYTES 

1 

100 

111 

YDD 

DDD 

DDD 

D=pairs  of  alphanumer ics 

DD  DDD 

DDD  pairs 

of  bytes 

follow 

the  above  LPR  commands. 

Internal  Self-test 

124000 

I TESTS 

1 

010 

100 

000 

000 

000 

Select  Peripheral  Device 

1 3000d 

LPA 

1 

Oil 

000 

000 

000 

ODD 

DD  =  test  number  -  1 
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NAME 

tm  -  TM-ll/TU-10  magtape  interface  with  filespacing 
DESCRIPTION 

The  files  *mtCO-73  refer  to  the  DEC  TU10/TM11  magtape.  File 
names  with  the  same  numerical  suffix  operate  the  same  physi¬ 
cal  drive  but  with  different  opening  and  closing  actions. 
On  DIGI— DATA  (trademark)  drives  file  numbers  with  the  high 
order  bit  (04)  set  refer  to  the  same  physical  drive  but  at 
1600FPI  density  instead  of  800FPI.  Thus  files  0  and  4  refer 
to  the  same  DIGI-DATA  drive  but  at  SOOFPI  and  1600FPI  densi¬ 
ties  respectively. 

Each  standard  (cooked)  file  on  tape  starts  just  after  a  file 
mark  or  the  beginning  of  tape  (BOT)>  consists  of  a  series  of 
312  byte  records*  and  terminates  with  at  least  one  end-of- 
file  mark  (EOF).  To  some  extent*  the  system  makes  it  possi¬ 
ble*  if  inefficient*  to  treat  the  tape  like  any  other  file. 
Seeks  have  their  usual  meaning  and  it  is  possible  to  read  or 
write  a  byte  at  a  time.  Writing  in  very  small  units  is 
inadvisable*  however*  because  it  tends  to  create  monstrous 
record  gaps.  On  a  cooked  device  that  is  opened  for  writing* 
reading  an  EOF  returns  a  312  byte  block  of  zeros  to  allow 
the  operating  systems  read  before  write  mechanism  to  extend 
tapes  with  small  writes.  Otherwise  reading  an  EOF  returns 
an  error  status  from  the  cooked  devices. 

Files  opened  for  writing  whose  last  action  was  not  a  read 
write  three  file  marks  either  when  closing  or  before  seeking 
backward.  The  files  mtCO-73  stay  at  their  current  position 
when  opened  and  when  closed  return  to  their  starting  posi¬ 
tion.  The  files  bu  mtCO-73  backup  over  the  current  file 
mark  to  a  position  just  after  the  previous  file  mark  or  BOT 
when  opened.  When  closed*  they  also  return  to  their  start¬ 
ing  position.  The  files  rw  mtCO-73  stay  at  their  current 
position  when  opened  and  rewind  to  BOT  when  closed.  The 
files  nrw  mtCO-73  also  stay  at  their  current  position  when 
opened.  When  closed  after  reading*  these  files  advance  the 
tape  to  just  past  the  next  file  mark*  ready  to  read  the  next 
file.  Hence*  to  skip  a  file*  simply  open  the  non-rewinding 
device  for  reading  and  then  close  it.  After  writing  file 
marks  when  closing*  the  tape  is  positioned  immediately  after 
the  first  file  mark*  ready  to  extend  the  tape  by  writing  yet 
another  file. 

The  files  discussed  above  are  useful  when  it  is  desired 
to  access  the  tape  in  a  way  compatible  with  ordinary  files. 
When  foreign  tapes  are  to  be  dealt  with*  and  especially  when 
long  records  are  to  be  read  or  written*  the  ''raw''  inter¬ 
face  is  appropriate.  The  files  corresponding  to  »mtCO-73 
are  named  »rmtCO-73.  Each  read  or  wr i te  call  reads  or 
writes  the  next  physical  record  on  the  tape.  In  the  write 
case  the  physical  record  has  the  same  length  as  the  buffer 
given.  During  a  read*  the  record  size  is  passed  back  as  the 
number  of  bytes  read*  provided  it  is  no  greater  than  the 
buffer  size;  if  the  physical  record  is  longer  than  the 
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buffer#  the  first  part  of  the  data  fills  the  buffer  and  an 
error  is  indicated.  In  raw  tape  I/O#  the  buffer  must  begin 
on  a  word  boundary.  However#  the  buffer  length  may  be  odd 
or  even.  Seeks  are  allowed  on  the  raw  device.  Each  physi¬ 
cal  record  is  treated  internally  as  though  it  were  exactly 
S12  bytes  (including  tape  marks)#  so  that  a  seek-by-blocks 
system  call  will  actually  seek  by  records.  During  a  seek  on 
the  raw  device#  tape  marks  are  counted  as  one  block.  On  the 
cooked  device#  an  error  will  be  returned  if  the  seek  tries 
to  cross  a  tape  mark.  On  the  raw  device#  an  error  is  only 
returned  if  the  seek  tries  to  cross  a  double  tape  mark, 
leaving  the  tape  positioned  after  the  first  of  the  pair. 

When  the  non-rewinding  raw  files  nrw  rmtCO-73  have  just  read 
a  file  mark  in  reaching  the  current  position#  other  than  any 
EOF  that  may  precede  the  entire  file#  these  files  do  not  ad¬ 
vance  any  further  when  closed.  A  seek  just  before  closing 
can  redefine  the  current  position. 

An  end-of-file  may  be  written  on  the  raw  devices  by  specify¬ 
ing  a  write  buffer  length  of  zero.  Such  a  file  mark  also 
counts  as  312  bytes  when  repositioning  the  file. 

Signals  may  interrupt  the  tape  open  procedure  so  that  a 
processes  may  be  immediately  terminated  without  waiting  for 
the  drive  to  complete  tape  movement.  However#  the  device 
will  remain  occupied  until  closed.  Although  after  an  inter¬ 
rupted  opening  or  I/O  errors  from  the  previous  close#  rewind 
and  skip  forward  actions  do  not  occur  when  the  tape  is 
closed#  the  device  continues  with  any  backward  preposition¬ 
ing.  On  the  raw  device#  a  wait  for  tape  seek  operations  may 
also  be  interrupted  prior  to  the  actual  data  transfer.  In 
this  case#  the  seek  operation  is  completed  but  the  device 
does  not  transfer  data  and  the  file  pointer  is  not  advanced. 

The  non-rewinding  files  nrw  mtCO-73  and  nrw  rmtCO-71  are 
also  named  smt CO-71  and  srmtCO-73. 


DIAGNOSTICS 

Except  as  noted  above#  when  the  cooked  device 
a  file  mark  or  the  raw  device  tries  to  pass 
marks  the  error  number  EFBIG  (27)  is  returned 
request. 


tries  to  cross 
a  pair  of  file 
to  the  read 


Only  one  file  correspond ing  to  a 
Attempts  to  multiply  open  such 
If  a  physical  error  occurs  during 
of  a  previous  close  operation  or 
fore  opening#  the  pending  open  a 
ENXIO.  In  particular#  an  attempt 
as  bu  rmtO  when  the  device  is  air 
ginning  of  tape#  is  such  an  e 
hardware  end  of  tape  also  generat 
the  tape. 
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FILES 

/dev/mt? 

/dev/rmt? 

/dev/bu_mt? 

/dev/bu_rmt? 

/dev/rw_mt? 

/dev/rw_rmt? 

/dev/nrw_mt? 

/dev/nrw_rmt? 

/dev/smt? 

/dev/srmt? 


SEE  ALSO 

bu  (I)>  skp  (I).  rewind  (I).  eot  (I).  tp  (I).  dd  (I).  seek 
(II) 


AUTHOR 

Robert  L.  Kirby 

BUGS 

If  any  non-data  error  is  encountered>  it  refuses  to  do  any¬ 
thing  more  until  closed.  After  non-data  errors  the  tape  may 
lose  position.  Such  errors  can  be  generated  by  using  the 
wrong  tape  density  or  from  attempting  to  read  a  virgin  por¬ 
tion  of  the  tape. 


At  the  expense  of  being  larger.  this  handler  corrects 
several  difficulties  with  the  Harvard  tape  handler.  When 
closing  the  non-rewinding  files  processing  must  waiting  for 
the  forward  seek  to  complete.  Often  this  creates  an  unkill- 
able  process  that  excessively  ties  up  a  terminal.  In  raw 
I/O.  there  should  be  a  way  to  perform  backward  file  spacing. 
After  specifying  tape  repositioning  with  a  seek  on  the  raw 
files.  the  next  I/O  request  locks  the  requesting  process  in 
core  while  moving  the  tape.  This  can  prevent  other 
processes  from  using  the  CPU  for  an  unnecessarily  long 
period.  A  write  buffer  length  of  2  bytes  is  converted  to  a 
length  of  4  bytes  to  avoid  conflicts  with  the  writing  of 
file  marks.  However,  the  user  process  is  only  told  that  2 
bytes  were  written.  This  extended  buffer  must  fit  within 
the  user's  area.  When  writing  a  file  mark,  the  buffer  ad¬ 
dress  must  be  on  a  word  boundary  within  the  user's  assigned 
area. 


As  originally  distributed,  unmodified 
the  bytes  read  to  an  even  number, 
file  spacing,  and  do  not  support  writi 
mode.  Furthermore.  unmodified  tape 
tape  controllers  (like  OIGI-OATA)  whi 
names  to  the  same  physical  drive. 


tap 
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The  optional.  Harvard  sttu  commands  are  not  installed  to 
save  core  and  discourage  incompatibilities.  Sttu  commands 
would  be  more  appropriate  for  changing  densities.  parity, 
error  handling.  on-line  status.  or  the  default  number  of 
file  marks  written. 
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INTRODUCTION  TO  CXAP 

CXAP  is  a  group  of  C-callable  subprograms.  It  is  modelled  after 
the  XAP  USER'S  MANUAL.  These  subprograms  permit  basic  I/O  opera¬ 
tions  on  picture  files. 

Each  picture  created  by  CXAP  is  comprised  of  a  header  section  and 
a  picture  section.  The  header  section  is  a  6  word  record  (12 
bytes)  at  the  beginning  of  the  picture  file. 

The  picture  section  begins  immediately  after  the  header  section. 
Each  row  of  a  picture.  starting  with  the  first  row.  is  stored  as 
one  logical  record  in  the  picture  section.  Each  picture  row  has 
the  same  length.  All  CXAP  pictures  are  stored  sequentially, 
where  row  k  follows  row  k-1. 

A  CXAP  picture  file  can  be  any  one  of  five  byte  sizes.  A 
picture's  byte  size  represents  the  number  of  bits  needed  to  store 
the  largest  picture  value  in  a  picture  file.  Byte  sizes  are 
powers  of  2.  where  the  number  of  bits  per  pixel  can  range  from  1 
to  16. 

It  is  assumed  that  a  user  of  CXAP  has  knowledge  of  the  C  program¬ 
ming  language.  In  the  subprograms  contained  in  CXAP.  all  index¬ 
ing  begins  at  zero.  All  information  stored  in  arrays  is  stored 
in  row-major  order,  i.  e.  .  the  column  increments  the  fastest.  All 
CXAP  subprograms  are  functions  and  return  one  of  three  values.  -I 
on  error.  0  on  end-of-file  and  +1  on  success. 

The  following  are  the  subprograms  in  CXAP: 


BREAD (VII ) 
COPYDN(VII) 
CQPYUP (VII) 
HEADER (VI I ) 
MWR ITE (VII) 
PACK (VI I ) 
PREAD(VII) 
PWRITE(VI I ) 
REX (VII) 
SETUPB (VII) 
SETUPR (VII) 


read  the  next  row  of  a  bordered  picture 
copy  a  row  down 
copy  a  row  up 

obtain  the  header  of  a  picture 
write  multiple  copies  of  a  picture  row 
pack  the  contents  of  a  picture  row 
read  the  next  n  row(s)  of  a  picture 
write  the  next  n  row(s)  of  a  picture 
read  and  extend  a  picture  row 

open  a  picture  file  with  a  border  surrounding  it 
open  a  picture  file  for  reading 
open  a  picture  file  for  writing 


A 
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UNPACK(VII)  unpack  the  contents  of  a  picture  roui 

.XCLOSE(VII)  close  a  picture  file 

ZWRITE(VII)  write  a  row  of  reroes  to  output  picture 


AUTHOR 

Philip  A.  Dondes 


SEE  ALSO 

C  Reference  Manual 

XAP  USER'S  MANUAL,  CN-21 
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CXAP(V) 


CXAP  PICTURE  FILE  STRUCTURE 

There  exist  two  types  of  CXAP  picture  files,  disk  files  and  tape 
files.  CXAP  disk  picture  files  are  comprised  of  two  sections,  a 
header  section  and  a  data  section.  The  header  section  is  a  6 
word  integer  vector  that  starts  at  the  beginning  of  a  picture 
file.  The  following,  in  C-language  notation,  is  the  definition 
of  this  vector: 

VECT0RC03  -  unused. 

VECTORC13  -  the  number  of  columns  in  the  picture, 

VECTOR! 23  -  unused, 

VECTORC33  -  the  number  of  rows  in  the  picture, 

VECTORC43  -  unused, 

VECTORC53  -  the  pixel  size  of  the  picture, 

where  VECTOR  is  the  picture  header.  The  description  of  a 
picture's  header  is  very  straight  forward  except  perhaps  for  the 
fifth  element.  This  word  is  referred  to  as  a  picture's  pixel 
size  or  simply,  as  the  size  of  a  picture.  (Do  not  mistake  this 
to  mean  a  picture's  dimensions,  i.  e.  ,  the  number  of  columns  and 
the  number  of  rows  in  a  picture.  )  If  we  let  SIZE  represent  a 
picture's  pixel  size,  then  1  <=  SIZE  <=  5,  where  2**(SIZE-1>  bits 
comprise  a  pixel. 

A  picture's  pixel  size  has  great  significance  when  one  considers 
the  range  of  values  that  a  picture  may  assume.  The  following 
table  describes  a  picture's  range  with  respect  to  its  pixel  size. 

Pixel  size  !  Bits  per  pixel  !  Range 


1  !  1  !  0  or  1 

2  i  2  i  0  to  3 

3  !  4  !  0  to  7 

4  !  S  !  0  to  255 

5  !  16  !  -32768  to  32767 

The  data  section  contains  integer  pictorial  data.  If  we  define 
NCOL  as  the  number  of  columns  in  a  picture  and  NROW  as  the  number 
of  rbws  in  a  picture,  the  picture  section  consists  of  NROW  rows 
of  physical  data  and  NCOL  columns  of  logical  data.  If  we  let 
PIXUD  *  16/<2**<SIZE-1 ) ),  then  the  physical  length  of  picture  row 
(in  bytes)  is  computed  by  the  C-language  expression 
( NCOL/P I  XWD*2 )  +  <  NCOL7.P  I X  WD>0?  1:0). 

A  CXAP  disk  picture  is  a  sequential  picture  stored  in  a  packed 
format.  Only  2**<SIZE-1)  bits  are  stored  for  each  pixel  when  a 
picture  is  written  to  a  disk  file.  If  BUF  is  a  C-language  in¬ 
teger  vector  dimensioned  to  NCOL  where  each  element  of  BUF  con¬ 
tains  a  pixel  value,  then  the  pixels  are  packed  towards  BUFC03 
before  being  written  to  disk  file.  Conversely,  the  pixels  are 
unpacked  towards  BUFCNCOL-13  just  after  being  read  from  a  disk 
file.  A  standard  CXAP  picture  should  be  stored  left  to  right  and 
from  top  to  bottom.  The  least  significant  bit  of  a  pixel  is  al¬ 
ways  the  low  order  bit,  i.  e.  ,  the  rightmost. 
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CXAP  tape  picture  files  are  significantly  different  in  format 
from  disk  files.  Unlike  disk  files*  tapes  files  do  not  contain  a 
header  and  therefore  contain  only  picture  data.  The  picture  data 
is  stored  on  tape  as  NROW  records  of  physical  data  with  NCQL 
frames  of  logical  data.  There  is  no  packing  done  when  a  tape 
file  is  created  so  that  if  a  picture's  pixel  size  is  less  than 
five*  only  one  byte  of  data  is  written  for  each  pixel.  Other¬ 
wise*  two  bytes  are  written.  The  significant  bits  of  data  will 
always  be  the  low  order  bits  of  a  tape  frame.”  For  pictures  with 
a  pixel  size  equal  to  five*  the  low  order  byte  is  written  first, 
followed  by  the  high  order  byte.  Every  picture  will  have  one 
end-of-file  mark  written  at  the  end  of  its  last  record. 
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NAME 

bread  -  read  the  next  row  of  a  bordered  picture. 

SYNOPSIS 

int  bread  (area. buff er, ptr, &b ias > 
int  areaC303 

int  b uf f er C d ep th 3 Cr 1 en t h 3 
int  ptrCdepth] 
int  bias 

int  depth 
int  iwC43 
int  rlenth 

DESCRIPTION 

area  work  area  for  CXAP 

buffer  input  buffer  as  supplied  to  setuob 

ptr  vector  of  subscripts  as  supplied  to  setuob 

bias  position  of  the  first  point  in  each  row 

depth  maximum  number  of  rows  kept  in  buffer 

iw  user's  input  window 

rlenth  maximum  number  of  columns  kept  in  buffer 

Bread  reads  the  next  row  of  a  bordered  picture.  If  iwC  33 
is  not  finished,  three  alternatives  are  present.  The  next 
row  of  the  picture  may  be  read  into  buffer  .  a  row  in  buffer 
may  be  copied  upward  to  create  the  top  border,  or  a  row  in 
buffer  may  be  copied  downward  to  create  the  bottom  border 
using  the  internal  procedures  rex,  coduup  and  cooudn, 
respectively.  Rex  is  also  used  to  extend  a  row  right  and 
and  if  needed,  left.  The  row  of  picture  points  to  be  pro¬ 
cessed  for  some  row  k  is: 

buf  f  er  Cotr  C  k  3  3  Cb ias  3  >  ,  buffer!  n  t r  C  k  3  3  Cb  ias+iwC  -23-13. 

The  set  of  picture  rows  to  be  processed  for  some  picture  is: 

bufferEotrCdeoth/  23  3,  .  .  .  ,  bufferCotrCdeoth/  23+  iwC  33-13. 

Unlike  setuor  ,  no  priming  of  the  input  buffer  need  be  done. 
After  the  initial  call  to  setuob  ,  the  first  row  of  the  in¬ 
put  picture  can  be  found  in  row  depth/  2  of  the  input 
buffer. 

If  the  user  tries  to  read  more  than  i_wC  33  rows,  an  end-of- 
file  will  be  returned. 

Function  value  is  -1  on  error,  0  on  end-of-file  and  +1  on 
success 
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FILES 

/mnt/ph  i  1/c  xap/f  unc/header.  c  source  code 

/mn t/ph i 1 /c x ap /ar ea. d ef ine  definitions  for  CXAP 

/mnt/ph i 1/c xap. lib  object  cade 

DIAGNOSTICS 

"File  not  to  be  read"  input  file  mas  set  up  for 

write-on  1 y 

"Read  error"  error  on  attempt  to  read 

from  picture  file 


AUTHOR 

Philip  A.  Dondes 

SEE  ALSO 

copy dn  < VI I ) 
copyup (VII) 
pread (VII) 
rex (VI I ) 
setupb ( VII ) 


BUGS 
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NAME 

copydn  -  copy  a  row  down. 
SYNOPSIS 

int  cooudn  (area/ buffer, ptr) 
int  areaC303 

int  b uf f er C d ep th 3 C r 1 enth 3 
int  ptrCdepthl 

int  depth 
int  rlenth 


DESCRIPTION 

area  work  area  for  CXAP 

buffer  input  buffer  as  supplied  to  setup b 

ptr  vector  of  subscripts  as  supplied  to  setup b 


depth  maximum  number  of  rows  kept  in  buffer 

rlenth  maximum  number  of  columns  kept  in  buffer 


Cooudn  copies  a  row  in  buffer  downward  to  create  the  bottom 
border  for  a  picture  which  was  opened  using  setup  b . 
Buffer  Co  tr  C  03  will  be  the  recipient  of  the  most  recently 
reflected  row  when  the  need  arises  to  create  the  bottom 
border  of  a  picture. 


Function  value  is  always  +1  indicating  success. 


FILES 

source  code 
definitions  for  CXAP 
object  code 

DIAGNOSTICS 

AUTHOR 

Philip  A.  Dondes 

SEE  ALSO 

bread (VI I ) 
setupb (VII) 


/mnt/ph i 1/c xap/f unc/copydn. c 
/mn t/ph i 1 /c xap /area,  define 
/mnt/ph i 1/c xap.  lib 


BUGS 


J 


1 
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NAME 

copyup  -  copy  a  row  up. 
SYNOPSIS 

int  c  op  u  uo  ( ar ea>  b uf f er ,  p tr ) 
int  areaC303 

int  bufferCdepth3Crlenth3 
int  p  tr  C  d  ep  th  3 

int  depth 
int  rlenth 


DESCRIPTION 

area  work  area  for  CXAP 

buffer  input  buffer  as  supplied  to  s e tup b 

ptr  vector  of  subscripts  as  supplied  to  setup b 


depth  maximum  number  of  rows  kept  in  buffer 

rlenth  maximum  number  of  columns  kept  in  buffer 


Copuup  copies  a  row  in  buffer  upward  to  create  the  top  bord¬ 
er  for  a  picture  which  was  opened  using  s  e  t  u  p  b . 
BufferCptrCdepth-  13  will  be  the  recipient  of  the  most  re¬ 
cently  reflected  row  when  the  need  arises  to  create  the  top 
border  of  a  picture. 


Function  value  is  always  +1  indicating  success. 


source  code 
definitions  for  CXAP 
object  code 

DIAGNOSTICS 

AUTHOR 

Philip  A.  Dondes 

SEE  ALSO 

bread (VI I ) 
setupb(VII) 


FILES 

/mnt/ph i 1/c xap/func/copyup.  c 
/mnt/p h i 1 /c x ap /area.  define 
/mnt/phil/cxap.  lib 
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HEADER (VI I) 


NAME 

header  -  obtain  the  header  of  a  picture. 
SYNOPSIS 

int  header  (file<hbuf) 

char  *file 
int  hbufC63 


DESCRIPTION 

file  CXAP  picture  file 

hbuf  storage  for  header  information 

Head er  reads  the  first  12  bytes  of  file  into  hbuf.  Pile  is 
closed  before  a  return  is  made. 


The  description  of  hbuf  is: 


hubfCOl  =  unused; 


hbufCll  =  #  columns  in  picture; 

hubfC23  =  unused; 

hbufC3!  =  #  rows  in  picture; 

h ub f C41  *  unused; 

hbufC51  =  byte  size  of  picture. 


Function  value  is  -1  on  error  and  +1  on  success. 


FILES 

/mnt/ph i 1/c xap/func/header.  c 
/mnt/ph i 1 /c xap /ar ea.  define 
/mn t/p h i 1 /c xap . lib 


source  code 
definitions  for  CXAP 
object  code 


DIAGNOSTICS 

"Source  file  not  opened" 
"Source  header  not  read" 
"Source  file  not  closed" 


user's  picture  file  was 
not  opened 

header  of  picture  file 
was  not  read 

user's  picture  file  was 
not  closed 


AUTHOR 

Philip  A.  Dondes 
SEE  ALSO 


BUGS 
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NAME 

ioinfo  -  input  picture  information 


SYNOPSIS 

int  ioinfo 

(min.  msg .  argc.  argv.  ifile.  ofile.  i  w,  ci.  ri.  shift,  size) 


int  *min 

char  *msg 

int  argc 

char  **argv 

char  *ifile 

char  *ofile 

int  iwC43 

int  *ci 

int  *ri 

int  *shift 

int  *size 


DESCRIPTION 

min 

msg 

argc 

argv 

ifile 

ofile 

iw 


c  i 
r  i 

shift 

size 


minimum  number  of  arguments  for  execution  of  pro¬ 
gram 

usage  message  (printed  if  insufficient  number  of 

command  line  parameters  are  present) 

argument  count 

argument  vector 

input  file  for  reading 

output  file  for  writing 

input  window,  where  elements  refer  to  first  column, 
first  row.  #  of  columns  and  #  of  rows,  respective¬ 
ly- 

column  increment  to  allow  sampling  of  input  columns 
row  increment  to  allow  sampling  of  input  rows 
bit-wise  shift  for  pixels 

byte  size  (as  defined  by  CXAP)  of  picture 


Ioinfo  is  a  routine  which  obtains  all  input  from  the  user's 
command  line.  It  is  used  in  conjunction  will  picture  han¬ 
dling. 


If  aroc  is  less  than  min,  mso  is  printed  to  the  error  output 
file  and  execution  stops.  mso  should  be  the  usage  line  for 
the  execution  of  a  program.  Otherwise,  iwCOl,  iwC 1 3,  i wC21 ■ 
iwC31 ,  c i ,  r i ,  shift  and  size  are  initially  set  to 
1,1.1024,1024.1,1.0  and  4,  respectively.  If  ifile  does  not 
begin  with  "/dev",  then  the  input  picture  file  is  assumed  to 
be  on  disk.  The  header  information  is  read  from  ifile  and 
iwCS’}  iu£C33  and  size  are  set  to  the  actual  picture  header. 
If  ifile  begins  will  "/dev",  the  input  file  is  assumed  to  be 
a  system  device  and  is  let  alone.  ofile  is  then  swapped  to 
contain  the  second  argument  of  the  command  line.  All  of  the 
remaining  arguments  on  the  command  line  are  copied  to  their 
respective  parameters,  provided  the  arguments  exist.  If 
they  do  not,  they  retain  their  default  values. 


L 
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FILES 

/mnt/phil/cxap/prag/ioinfo 
/mnt/ph i 1 /c xap /f unc/h ead er .  c 
/mnt/ph  i  1/uti  l/cvsu/ap.  c 


source  code 

reads  a  picture's  header 
swaps  a  character  vector 


DIAGNOSTICS 

"Usage:  ..."  program  usage  line 

"file  not  opened"  the  input  picture  file 

(on  disk)  was  not  opened 
for  a  header 


AUTHOR 

Philip  A.  Dondes 

SEE  ALSO 

CXAP (VII) 


BUGS 


i 


I 
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MWR ITE (VII) 


NAME 

mwrite  -  write  multiple  copies  of  a  picture  row. 
SYNOPSIS 

int  mwrite  (area< num, vector ) 

int  areaC303 
int  num 

int  vectorCnum  *  rlenth] 

int  iwC43 
int  rlenth 


DESCRIPTION 

area  work  area  for  CXAP 

num  number  of  rows  to  be  written  out  to  the  picture  as¬ 

sociated  with  area 

vector  output  buffer  to  be  copied  num  times 


iw  user's  input  window 

rlenth  maximum  number  of  columns  kept  in  user's  input 
buffer 


Mwr i t e  writes  multiple  copies  of  a  picture  row.  If  num  it 
less  than  1,  an  end-of-file  is  immediately  returned.  Other¬ 
wise.  pwr ite  is  called  num  times  with  parameters  area.  1  and 
vector. 

Function  value  is  -1  on  error.  0  on  end-of-file  and  +1  on 
success. 


FILES 

/mnt/ph i 1 /c x ap /f unc /mwr i te.  c 
/mnt/ph i 1 /c xap /area,  define 
/mnt /p h i 1 /c xap .  lib 


source  code 
definitions  for  CXAP 
object  code 


DIAGNOSTICS 

"File  not  to  be  written" 
"Output  file  not  written 


output  file  was  set  up 
for  read-only 
error  when  write  was  at¬ 
tempted  on  output  file 


AUTHOR 

Philip  A.  Dondes 

SEE  ALSO 

pwrite(VII) 
setupw( VI I ) 


BUGS 
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NAME 

pack  -  pack  the  contents  of  a  picture  row. 
SYNOPSIS 

int  pack  ( buf f er,  nump i x.  p i xwd ) 

int  b uf f er C d ep th 3 Cr 1 enth  ] 
int  numpix 
int  pixwd 

int  depth 
int  rlenth 


DESCRIPTION 

buffer  input  buffer  as  supplied  to  setupb  or  setuor 

numpix  number  of  pixels  in  buffer 

pixwd  number  of  pixels  to  pack  per  word 

depth  maximum  number  of  rows  kept  in  buffer 

rlenth  maximum  number  of  columns  kept  in  buffer 

Pack  will  pack  a  picture  row.  A  picture's  density  is  deter¬ 
mined  from  the  picture's  byte  size#  where  2-‘"(SIZE-l )  is  the 
number  of  bits  per  pixel  where  SIZE  is  the  picture  byte 
size.  If  o i xwd  is  0  or  1/  no  packing  is  done  and  control 
returns  immediately.  Otherwise,  the  contents  of  buffer  are 
packed  by  shifting  the  pixels  to  the  right  side  of  buffer  so 
that  there  are  o i xwd  pixels  in  each  word  of  buffer. 

Function  value  is  -1  on  error  and  +1  on  success. 


FILES 

/mnt/ph i 1 /c xap / f unc /pac k . c  source  code 

/mnt/ph i 1 /c xap /area,  def ine  definitions  for  CXAP 

/mnt/ph i 1/c xap , lib  object  code 

DIAGNOSTICS 

"Illegal  packing  density"  pixels  per  word  parameter 

is  less  than  0  or  greater 
than  16 


AUTHOR 

Philip  A.  Dondes 

SEE  ALSO 

pwrite<VII) 
pread (VII) 


BUGS 


L 


1 
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PREAD(YII) 


NAME 

pread  -  read  the  next  n  row(s>  of  a  picture. 
SYNOPSIS 

int  pread  (area.  num) 

int  areaC303 
int  num 


int  depth 
int  iwC43 
int  ptrCdepth  3 
int  rlenth 

buffer[depth3Crlenth3 


DESCRIPTION 

area  work  area  for  CXAP 

num  next  num  rows  are  read  into  buffer 


depth 
iw 
p  tr 

rlenth 

buffer 


maximum  number  of  rows  kept  in  buffer 
user's  input  window 

vector  of  subscripts  as  supplied  to  setupb  or 
setupr 

maximum  number  of  columns  kept  in  buffer 
input  buffer  as  supplied  to  setupb  or  setupr 


Pread  reads  the  next  num  rows  of  the  picture  associated  with 
area  into  buffer  provided  that  ijwC  3]  is  not  exceeded.  Each 
row  is  written  into  buf f erCptrC  03  3  before  the  p tr  vector  is 
rotated.  Ptr  is  rotated  such  that  p  tr  C  i3  »  p trC  i  +  13  for  0 
<=  i  <  depth-  1  and  ptrCdeoth-  13  =  p tr C  03. 

If  num  is  less  than  1  or  if  the  more  than  i^L  33  rows  are 
read,  an  end-of-file  will  be  returned. 

Unlike  setupb.  buffer  must  be  primed  by  the  user.  Depth 
rows  of  the  user's  window  must  be  read  before 
bufferCptrC  k33  <0  <=  k  <  depth)  will  contain  row  k+1  of  the 
input  window. 

Function  value  is  -1  on  error.  0  on  end-of-file  and  +1  on 
success. 


FILES 

/mnt/ph i 1 /c xap /func /pread .  c 
/mn t/p h i 1 /c xap /ar ea.  define 
/mnt/ph i 1/c xap. lib 


source  code 
definitions  for  CXAP 
ob  ject  code 


DIAGNOSTICS 

"File  not  to  be  read" 

M 


input  file  was  set  up  for 
wr i te-on 1 y 

error  on  attempt  to  read 
from  picture  file 


Read  error 
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AUTHOR 

Philip  A.  Dondes 

SEE  ALSO 

setupb  < VI I ) 
setupn ( VI I ) 
unpac  k ( VI I ) 

BUGS 


PWR ITE <  VI I ) 
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PWRITE(Vri) 


NAME 

pwrite  -  write  the  next  n  rcrni(s)  of  a  picture. 

SYNOPSIS 

int  owr i te  ( area. num. vec tor > 

int  areaC301 
int  nun? 

int  vectorCnum  *  rlenthl 

int  iwC41 
int  rlenth 

DESCRIPTION 

area  uiork  area  for  CXAP 

num  number  of  rows  to  be  written  out  to  the  picture  as¬ 

sociated  with  area 

vector  storage  containing  picture  values  to  be  written  out 
iw  user's  input  window 

rlenth  maximum  number  of  columns  kept  in  user's  input 
buffer 

Pwrite  writes  out  the  next  num  rows  of  a  picture.  The  pixel 
values  to  be  written  are: 

vector C  01.  .  .  .  .  vectorCnum»iwC  21-11. 

The  pixels  to  be  written  are  divided  into  num  groups  of 

i wC  21  pixels.  Group  k  (0  <  k  <=  num )  represents  output  row 

k. 

If  num  is  less  than  1.  an  end-of-file  is  returned  immediate¬ 
ly.  The  user  may  close  a  picture  file  prematurely  or  exceed 
the  33  count  without  any  mishap.  The  header  in  the  pic¬ 

ture  will  reflect  the  actual  number  of  rows  written,  as  op¬ 
posed  to  the  number  originally  specified  in  the  setupw  call. 

Function  value  is  -1  on  error.  0  on  end-of-file  and  +1  on 
success. 

FILES 

/mn  t/p  h  i  1 /c  xap /f  unc/p  wr  i  te.  c  source  code 

/mnt/ph i 1 /c xap /area,  define  definitions  for  CXAP 

/mnt/ph i 1 /c xap . 1 ib  object  code 

DIAGNOSTICS 

"File  not  to  be  written"  output  file  was  set  up 

for  read-only 

"Output  file  not  written"  error  when  write  was  at¬ 

tempted  on  output  file 
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AUTHOR 

Philip  A.  Dondes 

SEE  ALSO 

pac  k  <  VI I > 
setupw( VI I ) 

BUGS 


REX  <  VI I ) 
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NAME 

rex  -  read  and  extend  a  picture  row 
SYNOPSIS 

int  rex.  (area, buff er, ptr  ) 
int  areaC303 

int  buf f er C dep th ] Cr I enth ] 
int  ptrCdepthl 

int  depth 
int  rlenth 


DESCRIPTION 

area  work  area  for  Cxap 

buffer  input  buffer  as  supplied  to  setupb 

ptr  vector  of  subscripts  as  supplied  to  setupb 


depth  maximum  number  of  rows  kept  in  buffer 

rlenth  maximum  number  of  columns  kept  in  buffer 


Rex  reads  the  next  row  of  the  picture  associated  with  area 
using  oread  and  extends  the  row  right  and  if  needed,  left. 


Function  always  returns  +1  indicating  success. 


FILES 

/mnt/ph i 1/c xap /f unc/setupb.  c 
/mnt/ph i 1/c xap /area, define 
/mnt/ph i 1/c xap.  lib 

DIAGNOSTICS 

AUTHOR 

Philip  A.  Dondes 

SEE  ALSO 

bread (VII ) 
pread (VII) 
setupb (VII) 


source  code 
definitions  for  CXAP 
object  code 


SETUP B (VII) 


June  1979 


SETUPB (VII) 


NAME 

setupb  -  open  a  picture  file  with  a  border  surrounding  it. 
SYNOPSIS 

int  setupb  ( area,  name.  iw.  sh  if  t.  d  ep  th.  wi  d  th.  p  tr,  buf>  r  1  enth  ) 

int  areaC303 

char  *name 

int  iwC43 

int  shift 

int  depth 

int  width 

int  ptrCdepthl 

int  b uf C d ep th 3 Cr 1 en th 3 

int  rlenth 

DESCRIPTION 

area  work  area  for  CXAP 

name  input  picture  file  name 

iw  the  window  of  name  to  read 

shift  each  pixel  is  shifted  2'"'  shift  amount  before  being 

read 

depth  number  of  rows  to  keep  in  core  at  any  one  time 

width  number  of  columns  to  keep  in  core  at  any  one  time 

ptr  a  vector  of  subscript  values.  Ptr  C  03  is  the  sub¬ 

script  of  the  oldest  (topmost)  row  in  b  uf . 
PtrCdeoth-  13  is  the  subscript  of  the  newest  (bot¬ 
tommost)  row  in  buf . 

buf  storage  to  hold  input  picture  rows 

rlenth  the  dimensioned  row  length  of  buf.  It  must  be  at 

least  iiuC  23  +  width-  1. 

Setup b  opens  a  picture  file  with  a  border  surrounding  it. 
Setupb  is  very  useful  if  the  user  wishes  to  have  a  neighbor¬ 
hood  operation  defined  over  the  entire  picture.  including 
the  border.  The  border  is  created  by  reflecting  outward  the 
rows  and  columns  adjacent  to  the  perimeter  of  the  picture, 
depending  on  the  values  of  depth  and  width.  For  the  top  and 
bottom  borders,  the  columns  are  reflected  outward  before  the 
rows  are  copied  up  or  down. 

The  processed  point  for  a  4x5  neighborhood  is  marked  with  an 
X  in  the  following  example: 

PPPPP 

PPXPP 

PPPPP 

PPPPP 

Setuob  primes  buf  by  reading  the  first  depth-  1  rows  immedi¬ 
ately  and  creating  a  border,  as  needed.  After  the  first 
call  to  bread,  the  first  row  of  the  input  picture  can  be 
found  in  bufCdepth/  23 


If  depth  is  less  than  2.  an  end-of-file  is  returned. 


SETUP3 (VII) 


June  1979 


SETUPB (VII) 


Function  value  is  -1  on  error,  0  on  end-of-file  and  +1  on 
succ  ess. 


FILES 

/mn t/ph i 1 /c xap /f unc /s etup b .  c 
/mnt/ph i 1/c xap /area.  define 
/mnt/ph i 1/c  xap.  lib 


source  code 
definitions  for  CXAP 
object  code 


DIAGNOSTICS 

"Setupr  error  in  Bread"  the  function  call  to 

setuor  ii/as  unsuccessful 


The  error  messages  that  setupr  writes  also  apply. 


AUTHOR 

Philip  A.  Dondes 


SEE  ALSO 

copydn(VII ) 
copyup  < VI I ) 
rex (VII ) 
setupr (VII) 


BUGS 


SETUPR (VII) 


June  1979 


SETUPR (VI I ) 


NAME 

setupr  -  open  a  picture  file  for  reading 
SYNOPSIS 

int  setupr  (area,  name,  iw,  sh  if  t,  depth/ ptr,  buff  er,  rlenth  ) 

int  areaC303 

char  ♦name 

int  iwC43 

int  shift 

int  depth 

int  ptrCdepth  3 

int  buf f er C d ep th 3 Cr 1 enth 3 

int  rlenth 


DESCRIPTION 

area 

name 

iu> 

shift 

depth 
p  tr 


buffer 

rlenth 


work  area  for  CXAP 
input  picture  file  name 
the  window  of  name  to  read 

each  pixel  is  shifted  2''  shift  amount  before  being 
read 

number  of  rows  to  keep  in  core  at  any  one  time 
a  vector  of  subscript  values.  Ptr C  03  is  the  sub¬ 
script  of  the  oldest  (topmost)  row  in  buffer. 
PtrCdepth-  13  is  the  subscript  of  the  newest  (bot¬ 
tommost)  row  in  buffer, 
storage  to  hold  input  picture  rows 

the  dimensioned  row  length  of  buffer.  It  must  be 
at  least  iw.C  23 


Setupr  opens  a  picture  file  for  reading.  The  window  of  the 
picture  file  which  will  be  read  on  subsequent  calls  to  oread 
is  defined  by  the  iw,  parameter)  where 


iwC03  is  the  first  column  of  the  window, 
iwC13  is  the  first  row  of  the  window, 
iwC23  is  the  number  of  columns  to  read  and 
iwC33  is  the  number  of  rows  to  read. 


Setuor  is  used  only  for  ini t ia 1 i  la t i on  of  an  input  picture. 
All  buffer  priming  must  be  performed  by  the  user.  If  no 
priming  is  preferred,  setup b  and  bread  should  be  used. 

Function  value  is  -1  on  error,  0  on  end-of-file  and  +1  on 
success. 


FILES 

/mnt/ph i 1 /c xap / func / setupr .  c 
/mnt /p h i 1 /c xap /ar ea.  define 
/mnt/ph i 1 /c xap .  lib 


source  code 
definitions  for  CXAP 
object  code 


DIAGNOSTICS 

"Input  file  not  opened" 


error  result  when  name 
was  opened 

header  of  picture  file 
was  not  read 


Input  header  not  read" 


r 

SETUPS (VII ) 

"Window  invalid" 

"Seek  error" 

AUTHOR 

Philip  A.  Dondes 

SEE  ALSO 

setupb (VII > 


June  1979  SETUPR(VII) 


user's  window  (i.  e.  /  iw 
parameter)  is  invalid  for 
picture  file 

seek  to  first  pixel  in 
user's  window  failed 


3UGS 


1 


SETUP W< VI I ) 


June  1979 


SETUPW<  VI I ) 


NAME 

setupw  -  open  a  picture  file  for  writing 
SYNOPSIS 

int  setuow  (area.  name>  iut>  shift,  size) 

int  areaC303 
char  *name 
int  iwC43 
int  shift 
int  size 

DESCRIPTION 
area 
name 
iu) 

shift 
size 


DESCRIPTION 

Setupw  opens  a  picture  file  for  writing.  The  window  of  the 
picture  file  which  will  be  written  on  subsequent  calls  to 
pwri te  is  defined  by  the  ijw  parameter.  IwC  23  is  the  number 
of  columns  to  write  and  iwC  33  is  the  number  of  rows  to 
write.  IwC  03  and  iu»C  13  are  ignored.  The  output  picture 
file  corresponding  to  name  will  have  file  mode  0644. 

Function  value  is  -1  on  error  and  +1  on  success. 


work  area  for  CXAP 
input  picture  file  name 
the  window  of  name  to  write 

each  pixel  is  shifted  2'xshift  amount  before  being 
wr i tten 

byte  size  of  output  picture/  where  2A<  size  -1) 
describes  the  number  of  bits  for  each  pixel. 


FILES 

/mnt/ph i 1 /c xap /f unc /se tup w.  c 
/mnt/ph i 1/c xap /ar ea.  define 
/mnt/ph i 1/c xap .  lib 

DIAGNOSTICS 

"Output  file  not  opened" 
"Illegal  byte  size" 

"Output  header  not  written" 


source  code 
definitions  for  CXAP 
object  code 


output  picture  was  not 
opened 

byte  size  of  output  pic¬ 
ture  was  invalid 
header  was  not  written  to 
output  picture 


AUTHOR 

Philip  A.  Dond es 


SEE  ALSO 

pwrite(VII) 


UNPACK (VI I ) 


June  1979 


UNPACK (VI I) 


NAME 

unpack  -  unpack  the  contents  of  a  picture  row. 
SYNOPSIS 

int  unaac k  < buf f er,  nump i x.  p i xwd ) 

int  buf f er Cdep th 3 C r 1 en th 3 
int  numpix 
int  pixwd 

int  depth 
int  rlenth 


DESCRIPTION 

buffer  input  buffer  as  supplied  to  setupb  or  setupr 

numpix  number  of  pixels  in  buffer 

pixwd  number  of  pixels  to  pack  per  word 


depth  maximum  number  of  rows  kept  in  buffer 

rlenth  maximum  number  of  columns  kept  in  buffer 


Unpac  k  will  unpack  a  picture  row.  If  p i xwd  is  0  or  1,  no 
unpacking  is  done  and  control  returns  immediately.  Qthei — 
wise,  the  contents  of  buffer  are  unpacked  by  shifting  the 
pixels  to  the  left  side  of  buffer  so  that  there  is  only  one 
pixel  in  each  word  of  buffer. 

Function  value  is  -1  on  error  and  +1  on  success. 


FILES 

/mnt/p h i 1/c xap/func /unpac k.  c 
/mnt /ph i 1 /c xap /ar ea. define 
/mnt/ph i 1/cxap. lib 


source  code 
definitions  for  CXAP 
object  code 


DIAGNOSTICS 

"Illegal  unpacking  density" 


pixels  per  word  parameter 
is  less  than  0  or  greater 
than  16 


AUTHOR 

Philip  A.  Dondes 

SEE  ALSO 

pwrite(VII) 
setupb (VII) 
setupr (VII) 


BUGS 


XCLOSE (VI I ) 


June  1979 


XCLOSE(VII ) 


NAME 

xclose  -  close  a  picture  file 
SYNOPSIS 

int  xclose  (area) 
int  areaC301 


DESCRIPTION 

area  work  area  for  CXAP 


Xclose  closes  a  picture  file.  If  the  picture  file  associat¬ 
ed  with  area  was  opened  using  setuow*  the  picture  file  is 
checked  to  insure  its  correctness.  If  too  few  or  too  many 
rows  were  written  to  the  picture  file*  the  header  is  changed 
to  reflect  this  fact. 


Function  value  is  -1  on  error*  0  on  end-of-file  and  +1  on 
success. 


FILES 

/mnt/ph i 1/c xap/f unc/xc 1 ose.  c 
/mnt/ph i 1/c xap/area.  define 
/mnt/ph i 1/c xap. lib 


source  code 
definitions  for  CXAP 
object  code 


DIAGNOSTICS 

"Output  file  prematurely  closed" 
"Error  on  header  seek" 


"New  header  not  written" 
"File  not  closed" 


too  few  or  too  many  rows 
written  to  output  picture 
a  seek  to  the  beginning 
of  the  file  was  unsuc¬ 
cessful 

updated  header  was  not 
written  to  picture  file 
output  picture  file  not 
closed 


AUTHOR 

Philip  A.  Dondes 
SEE  ALSO 


BUGS 


r 


ZWRITE(VI I ) 


June  1979 


ZWRITE(VII) 


NAME 

zwrite  -  uirite  a  row  of  zeroes  to  a  picture. 

SYNOPSIS 

int  zur i te  (area, num) 

int  areaC303 
int  num 

int  iwC4I 
int  zbufC10243 

DESCRIPTION 

area  work  area  for  CXAP 

num  number  of  rows  to  be  written  out  to  the  picture  as¬ 

sociated  with  area 

iw  user's  input  window 

zbuf  vector  of  zeroes  to  be  written  to  output  picture 

Zwr i te  writes  out  num  rows  of  zeroes  to  the  output  picture 
associated  with  area.  Zbuf  is  initialized  to  zero  and  then 
a  call  is  made  to  o wr i t e  using  area,  num  and  zbuf  as  parame¬ 
ters. 


IwC  2]  must  be  not  be  greater  than  1024  in  length. 


Function  value  is  -1  on  error.  0  on  end-of-file  and  +1  on 
success. 


FILES 

/mnt/ph i 1/c xap /f unc / zwr i te.  c 
/mnt/ph i 1 /c xap /ar ea. define 
/mnt/phi 1/c xap. lib 


source  code 
definitions  for  CXAP 
object  code 


DIAGNOSTICS 

"Too  many  columns  in  picture" 
"File  not  to  be  written" 
"Output  file  not  written" 


length  of  an  output  pic¬ 
ture  row  exceeds  1024 
output  file  was  set  up 
for  read-only 
error  when  write  was  at¬ 
tempted  on  output  file 


AUTHOR 

Philip  A.  Dondes 

SEE  ALSO 

pwr ite (VI I ) 
setupwt VI I ) 


BUGS 
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GAP 


NAME 

GAP  -  GRINNELL  APPLICATION  PACKAGE 

DESCRIPTION 

GAP  is  a  group  of  C  compatible  routines  which  simplify  the 
interface  between  your  C  programs  and  the  GRINNELL  SYSTEMS 
display.  Included  in  the  package  are  functions  to  write  (and 
read)  rows/  columns  or  points  to  (or  from)  a  window  on  the 
display.  With  the  exception  of  one/  all  the  functions  return  a 
zero  value  when  no  errors  occur/  a  negative  value  when  an  error 
condition  is  detected.  The  one  exception  is  oront,  which  returns 
a  12-bit  pixel  value  on  no  error.  All  the  functions  access  a  16 
integer  buffer  which  is  set  up  by  the  qooen  function  as  a  window 
descriptor.  More  than  one  window  may  be  open  at  one  time  as  long 
as  each  has  its  own  descriptor  (The  descriptors  should  not  be 
used  by  the  user's  routines  (except  in  GAP  calls)  as  they  contain 
information  which  is  vital  to  the  GAP  functions). 

It  should  be  noted  that  all  points  are  referenced  using  the 
standard  Cartesian  coordinate  system  with  this  package.  That  is/ 
columns  are  numbered  consecutively  from  left  to  right  and  rows 
are  numbered  from  bottom  to  top  in  the  display  (not  top  to  bottom 
as  with  1108  XAP).  All  numbering  starts  with  zero  (i.e.  Ccolumn 
zero,  row  zero!  is  the  lower  lefthand  corner  of  the  display). 


USAGE 

cc  Cy our-C-routinesl  -lg 
SEE  ALSO 

c c ( I ) ■  Id ( I ) .  gr(IV) 

GRINNELL  SYSTEMS  User's  Manual 
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HEADER (V) 


NAME 

header  -  Format  of  GAP  image  header 


DESCRIPTION 

The  header  considered  standard  by  the  GAP 
routines  consists  of  six  words.  Words  O. 
contain  zeroes.  Word  1  contains  the  number  of 
image.  Word  3  contains  the  number  of  rows  in 
5  contains  the  minimum  number  of  bytes  needed 
el.  An  example  of  a  header  for  a  512  column 
graylevel  image  is  given  below. 


image  handling 
2,  and  4  always 
columns  in  the 
the  image.  Word 
for  each  pix- 
by  480  row  256 


headerCOl  < — 

z  ero 

headerCll  < — 

512 

headerC21  < — 

zero 

header C31  < — 

480 

headerC41  < — 

zero 

header C51  < — 

1 

This  format  is 

used  due  to 

many  programmi 

ng  languages 

the  need 
including 


of  compatibility  with 
Fortran,  C,  and  Lisp. 


SEE  ALSO 

put  (IV) 


-  1  - 


GO  FEN 


GOP  EN 


NAME 

gopen  -  Window  creation  function 

USAGE 

status  =  gopen(area,  fcol,  from,  ncol,  nrow); 

The  parameters  are: 

area  —  A  16  word  array  (or  structure)  used  onlu  by  the 
GAP  functions. 

f  col, 

frow  —  Define  the  lower  lefthand  corner  of  the  user's 
window.  These  are  actual  GRINNELL  column  and  row 
numbers  and  must  be  from  0  to  511. 

ncol, 

nrow  —  The  number  of  columns  and  rows  in  the  user's  win¬ 
dow  (maximum  size  =  512). 

VALUE  RETURNED 
zero  —  no  error 

nonzero  —  some  error  condition  was  detected  (operation  not  done) 
DESCRIPTION 

Gopen  is  used  before  all  other  GAP  functions  to  set  up  the 
user's  area  buffer  and  open  the  GRINNELL  device.  The  function 

parameters  are  used  to  define  the  physical  window  the  user  will 
be  manipulating  on  the  display.  Though  errors  are  detected 

relative  to  the  user's  window,  no  overlaps  of  separate  windows 
can  be  discovered  by  the  GAP  functions.  When  many  users  want  to 
use  the  display  at  one  time,  it  is  their  responsibility  to 
maintain  the  mutual  integrity  of  their  windows.  It  is  therefore 
strong  1  u  recommended  that  the  user  input  all  parameters  for  the 

gopen  function  (with  the  exception  of  'area')  at  the  time  of 

execution  of  the  user's  program. 

EXAMPLE 

i n t  abufferC163> 


i  f  (  g  op  en  (ab  uf  f  er ,  0,  0,  64,  64))  -C  /*•  NOTE  —  Single  user  */ 

printf( "Gopen  failed !\n"  ); 
e  x  i  t  (  ) ; 


This  will  open  the  device  and  set  up  'abuffer'  to  have  values  in 
it  which  define  the  user's  window  at  the  extreme  lower  left  hand 
comer  of  the  display.  The  columns  (and  rows)  of  the  window 
will  be  numbered  from  0  to  63. 


k 


GCLOSE 


GCLOSE 


NAME 

gclose  -  Close  out  a  window 

USAGE 

status  =  g c 1 ose ( area ) ; 

where  'area'  is  the  user's  16  word  buffer  used  in  the  oopen  call. 
VALUE  RETURNED 
zero  —  no  error 

nonzero  —  some  error  condition  was  detected  (operation  not  done) 
DESCRIPTION 

Gclose  is  used  to  close  out  a  window  when  the  user  is  finished. 
It  will  close  the  device  and  disable  certain  values  in  the  'area' 
buffer  which  have  significant  meaning  to  GAP  functions. 

EXAMPLE 

int  abufferC163; 


i  *  gopenCabuffer.  w»  x,  y,  z>; 


if  (gclose(abuffer  )  )  -C 

pr intf < "Gc 1 ose  didn't  work?\n"); 
ex  i  t  (  )  i 

> 


This  shows  the  general  way  to  close  a  window.  Note  that  if  an 
error  is  detected  by  □ c 1 ose  something  very  seriously  wrong  has 
occurred  in  your  program  which  needs  fixing ... 


GENTER 


GENTER 


NAME 

genter - Enter  values  into  a  window  descriptor 

USAGE 

status  =  genterlaresi  channel)  subchan>  bakgnd;  zurite>  dsize)) 
The  parameters  are: 

area  —  The  buffer  used  in  the  a  op  en  call 
channel  —  The  channels  to  enable  (if  zeroi  no  change) 
subchan  —  The  subchannels  to  enable  (if  zero>  no  change) 
bakgnd  —  Select  background  (1  *  light)  >1  =  dark) 
zwrite  —  Select  zero  write  (1  =  no  write)  >1  write) 
dsize  —  Select  double  size  pixels 
VALUE  RETURNED 
zero  —  no  error 

nonzero  —  some  error  condition  was  detected  (operation  not  done) 
DESCRIPTION 

Genter  is  used  to  change  the  default  values  for  the  channel) 
subchannel  and  write  mode  set  up  bg  the  gopen  call.  On  opening  a 
window)  a  on  en  will  select  the  image  channels)  enable  all 
subchannels)  select  a  dark  background)  enable  zero  writes  and 
select  single  size  pixels  (1  point  per  pixel).  To  change  these 
values  in  the  area  buffer)  the  user  should  use  genter.  Any 
parameters  which  are  zero  are  left  as  is  in  the  buffer. 

Care  must  be  taken  using  doub-le  size  I/O.  If  this  mode  is  set> 
the  logical  window  size  is  halved. 

EXAMPLE 

int  abuf f er C 161; 


l  =  gopen  (abuf  fer>  23>  46>  200<  200); 


i  f  ( g  enter  ( abuf  fer>  4>  0,  0)  0/  0))  -C 

pr intf ( "Genter  blew  up\n"); 
e  x  i  t  (  )  > 

> 

This  user  has  decided  to  manipulate  only  the  overlay  channel.  The 
subchannels  selected  are  left  as  they  are  in  the  buffer  abuf f er 
as  is  the  write  mode. 


A 


GCLEAR 


GCLEAR 


NAME 

gclear  -  Selective  clear  of  the  user's  window 

USAGE 

status  =  gclear(area»  fcol>  frow.  ncoL  nrow#  subchan); 

The  parameters  are: 

area  —  The  buffer  used  in  the  g oo en  call 
fcol, 

frow  —  Define  the  lower  lefthand  corner  of.  the  subwindow 
to  be  cleared  (relative  to  the  user's  window). 

ncoli 

nrow  —  The  number  of  columns  and  rows  in  the  subwindow, 
subchan  —  The  subchannels  to  clear 
VALUE  RETURNED 
zero  —  no  error 

nonzero  —  some  error  condition  was  detected  (operation  not  done) 
DESCRIPTION 

Qc 1  ear  is  used  to  clear  out  the  selected  subchannels  of  the 
subwindow  of  the  user's  window.  The  first-column  and  first-row 
parameters  sent  in  the  call  are  relative  to  the  lower  lefthand 
corner  of  the  window  set  up  by  the  a  op en  call.  The  subchannels  to 
be  cleared  are  selected  with  the  s ub c han  parameter.  If  sub c han 
is  zero<  the  subchannels  as  defined  in  the  area  buffer  are 
cleared.  The  subwindow  to  be  cleared  can  be  as  large  as  the  whole 
window  or  as  small  as  one  point  (no  larger#  no  smaller).  Note 
that  the  window  is  not  cleared  when  the  q  op  en  function  is 
invoked#  so  it  is  a  good  idea  to  use  the  a c 1  ear  call  immediately 
after  opening#  unless  you  want  to  manipulate  data  that  is  already 
in  your  window. 

EXAMPLE 

int  abufferC163; 


i  =  gopen(abuf fer#  23#  46#  100#  100);  /*  A  100  by  100  window  */ 

if  (gclear  (abuffer.  0.  0#  100#  100#  0))  -C 

printf ( "Can  't  clear  out  the  wind ow !  ! \n "  ) ; 
ex i t (  ) ; 

> 

This  will  open  a  100  by  100  window  at  physical  location  (23. 46). 
The  subchannels  have  been  defaulted  to  be  all.  The  a  c  1  ear  call 
will  then  clear  out  the  entire  window.  Note  the  relative  column 
and  row  starting  position  for  the  subwindow. 


A 


QWROW 


GWROW 


NAME 

gwrow  —  Write  out  a  row  to  a  window 
USAGE 

status  =  gwrow(area,  rbuf,  rnum,  rstart,  npts,  inc); 

The  parameters  are: 

area  —  The  buffer  used  in  the  a  op  en  call 

rbuf  —  The  user's  integer  array  containing  the  values  to 
be  written  out 

rnum  —  The  row  to  be  written  (relative  to  the  bottom  of 
the  window) 

rstart  —  The  column  to  start  writing  to  (relative  to  the 
left  of  the  window) 

npts  —  The  number  of  points  to  write  out 

inc  —  The  distance  (and  direction)  between  points 


VALUE  RETURNED 
zero  —  no  error 

nonzero  —  some  error  condition  was  detected  (operation  not  done) 
DESCRIPTION 

Gwrow  is  used  to  write  out  a  row  to  the  user's  window  on  the 
display.  The  row's  values  are  transferred  from  the  user's  buffer 
to  the  row  specified  in  the  call.  The  column  to  start  the  writing 
to  and  the  number  of  points  to  write  out  are  also  specified  in 
the  call.  The  inc  parameter  is  used  to  write  out  the  values  a  set 
distance  apart.  If  inc  is  negative  the  pixels  are  placed  from 
right  to  left  in  the  row.  It  is  the  user's  responsibility  to  make 
sure  that  the  number  of  points  to  be  written  out  will  not  violate 
the  window's  boundary.  If  too  many  points  are  requested  an  error 
condition  will  be  returned  and  the  operation  will  not  be  done. 

EXAMPLE 

int  abufferC161,  th i sr owC643 ,  somewhere; 


i  =  gop en ( abuf f er.  23,  46,  64,  64);  /*  A  64  by  64  window  */ 


if  ( gwrow<  abuf  f  er,  thisrow,  somewhere,  0,  64,  1))  -C 

printf< "ERROR  ON  ROW  WRITEXn"); 
exit  (  ) ; 

> 


This  will  write  out  64  values  in  thisrow  to 
Furthermore,  the  output  will  start  in  the 
pixel*  will  be  next  to  each  other. 


the  row  somewhere 
first  column  and  the 
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NAME 

gwcol  —  Writs  out  a  column  to  a  window 
USAGE 

status  =  gwcol(areai  cbuf;  cnunii  cstarti  nptsi  inc); 

The  parameters  are: 

area  —  The  buffer  used  in  the  aooen  call 

cbuf  —  The  user's  integer  array  containing  the  values  to 
be  written  out 

cnum  —  The  column  to  be  written  (relative  to  the  left 
of  the  window) 

cstart  —  The  row  to  start  writing  to  (relative  to  the 
bottom  of  the  window) 

npts  —  The  number  of  points  to  write  out 

inc  —  The  distance  (and  direction)  between  points 

VALUE  RETURNED 

zero  —  no  error 

nonzero  —  some  error  condition  was  detected  (operation  not  done) 
DESCRIPTION 

Gwc o 1  is  used  to  write  out  a  column  to  the  user's  window  on  the 
display.  The  column's  values  are  transferred  from  the  user's 
buffer  to  the  column  specified  in  the  call.  The  row  to  start  the 
writing  to  and  the  number  of  points  to  write  out  are  also 
specified  in  the  call.  The  i nc  parameter  is  used  to  write  out  the 
values  a  set  distance  apart.  If  inc  is  negative  the  pixels  are 
placed  from  top  to  bottom  in  the  column.  It  is  the  user's 
responsibility  to  make  sure  that  the  number  of  points  to  be 
written  out  will  not  violate  the  window's  boundary.  If  too  many 
points  are  requested  an  error  condition  will  be  returned  and  the 
operation  will  not  be  done. 

EXAMPLE 

int  abufferC163(  thiscolC64],  somewhere; 


i  *  gop en ( abuf f er i  23;  46 ,  64;  64);  /*  A  64  by  64  window  */ 


i f < g wc o 1 < ab uf f er ,  thiscol;  somewhere;  0 ,  64;  1))  < 

pr int f ( "ERROR  ON  COLUMN  WRITENn" ); 
e  x  i  t  <  ) ; 

> 

This  will  write  out  64  values  in  th  i  sc  o  1  to  the  column  somewhere. 
Furthermore;  the  output  will  start  on  the  first  row  and  the 
pixels  will  be  next  to  each  other. 
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NAME 

gwpnt  —  Write  out  a  point  to  the  display 
USAGE 

status  =  gwpnt(area,  value)  cnum,  rnum); 

The  parameters  are: 

area  —  The  buffer  in  the  a oo en  call 
value  —  The  integer  value  to  be  written  out 
cnum  —  The  window— relative  column  position  of  the  pixel 
rnum  —  The  wind ow— r e 1  a t i ve  row  position  of  the  pixel 
VALUE  RETURNED 
zero  —  no  error 

nonzero  —  some  error  condition  was  detected  (operation  not  done) 
DESCRIPTION 

Gwpnt  is  used  to  write  out  one  point  to  the  column  and  row 
position  specified  in  the  call.  The  value  sent  should  be  between 
0  and  4095  (the  function  will  notice  only  12  bits  of  the  integer 
sent).  With  this  function,  points  may  be  written  in  any  order  or 
direction  one  at  a  time.  It  can  be  used  for  border  outlining, 
special  symbol  creation,  etc. 

EXAMPLE 

int  abufferC16D; 
int  pntval,  x,  y; 


i  =  g op en ( ab uf f er ,  23,  46,  64,  64); 


i f ( gwpnt ( abuffer,  pntval.  x,  y>>  < 

printf("You  goofed.  Ha  ha!\n"); 
e  x  i  t  (  > ; 

> 

This  will  write  out  pntva  1  to  column  x.  and  row  y.  of  the  window 
defined  by  abuffer. 
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NAME 

guvec  —  Write  a  vector  in  a  window 
USAGE 

status  =  gwvec(area>  fcol,  frow.  lcol,  lrow,  type); 

The  parameters  are: 

area  —  The  buffer  used  in  the  a  op  en  call 

fcol  —  The  window-relative  first  column  of  the  vector 
frow  —  The  wi ndow— r e la t i ve  first  row  of  the  vector 
lcol  —  The  window-relative  last  column  of  the  vector 
lrow  —  The  window— relative  last  row  of  the  vector 
type  —  If  nonzero.  a  solid  rectangle  is  written 
VALUE  RETURNED 
zero  —  no  error 

nonzero  —  some  error  condition  was  detected  (operation  not  done) 
DESCRIPTION 

Gwvec  is  used  to  write  either  a  vector  or  a  rectangle  between  two 
points  in  the  user's  window,  depending  on  the  tuoe  parameter.  The 
vector  will  be  written  into  the  subchannels  that  are  selected, 
those  that  are  not  sel'-cted  will  be  zero  written  unless  the 
a  enter  command  has  been  used  to  change  this  mode. 

EXAMPLE 

int  abufferC161.  xO.  yO,  xl>  yi; 


i  •  gopen(abuffer,  23,  46,  64,  64);  /*  A  64  by  64  window  */ 


if  ( gwvec  <  abuffer,  xO.  yO,  xl,  yl,  0))  -C 

printf(" Could  not  write  the  vector !\n"  ); 
e  x  i  t  (  ) ; 

> 

This  will  write  out  a  vector  between  the  point  ( xO,  yO)  and 
the  point  (xl,  yl)  in  the  selected  subchannels.  Nonselected 
subchannels  will  be  cleared. 
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NAME 

gwcur  —  Write  a  cursor  to  a  window 
USAGE 

status  =  gwcur(area.  curnum,  col.  row.  onoff.  color). 

The  parameters  are: 

area  —  The  buffer  used  in  the  o op en  call 
curnum  —  The  cursor  to  write  <1  or  2) 
col. 

row  —  The  window-relative  position  for  the  cursor 

onoff  —  If  nonzero,  the  cursor  will  be  visible 

color  —  If  nonzero,  the  cursor  will  be  white.  else  it 

will  be  black  (if  onoff  is  nonzero) 


VALUE  RETURNED 
zero  —  no  error 

nonzero  —  some  error  condition  was  detected  (operation  not  done) 
DESCRIPTION 

Gwc ur  is  used  to  manipulate  the  cursors  in  the  user's  window. 
The  selected  cursor  will  be  written  to  window-relative  position 
(col. row).  In  addition,  the  cursor  can  be  turned  on  or  off  when 
it  is  positioned  and  the  color  can  be  selected  to  be  black  or 
white.  When  using  this  function,  care  should  be  taken  that  no 
other  user  is  manipulating  the  same  cursor. 

EXAMPLE 

int  abufferC16J,  mycur,  x,  y; 


i  *  gopen  (abuf  f  er.  23,  46,  64,  64); 


i f ( gwcur (abuf f er,  mycur,  x,  y,  1,  1))  { 

pr intf < "Can 't  manipulate  cursor ! \n"  ) ; 
ex i t  <  ) ; 

> 


This  will  write  cursor  mucur  to  window-relative  position  (x,  y). 

The  cursor  will  be  visible  and  the  color  will  be  white. 
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NAME 

gwstr  —  Write  an  alphanumeric  string  to  a  window 
USAGE 

status  =  gwstr(area.  string*  fcol,  from) 

The  parameters  are: 

area  —  The  buffer  used  in  the  g  oo  en  call 
string  —  The  string  (or  a  pointer  to  a  string) 
fcol* 

frow  —  The  position  in  the  window  for  the  lower  lefthand 
corner  of  the  first  character  of  the  string 


VALUE  RETURNED 
zero  —  no  error 

nonzero  —  some  error  condition  was  detected  (operation  not  done) 
DESCRIPTION 

Gwstr  is  used  to  write  a  string  of  characters  out  to  the  user's 
window  starting  at  relative  location  (fcol.frow)  and  proceeding 
from  left  to  right.  The  standard  ASCII  64  character  set  is  used. 
Each  character  can  be  thought  of  as  a  7X9  box  containing  some  bit 
pattern.  As  such*  the  last  column  which  can  be  the  start  of  a 
character  is  7  less  than  the  number  of  columns  in  the  user's 
window.  The  last  row  is  9  less.  Characters  are  written  into  the 
selected  subchannels  of  the  enabled  channels, 

EXAMPLE 

int  abuf f er C 163; 


i  =  g op en ( abuf f er<  O*  0.  512*  512); 


if (gwstr (abuffer,  "HI  MOM!!".  250,  250))  < 
printf("It  didn't  sag  hello. .. \n" ) ; 
e  x  i  t  (  > ; 

> 

This  will  write  out  the  string  "HI  MOM!!"  ap pr o x ima t e 1 y  in  the 
center  of  the  user's  window,  starting  at  location  (250*250) 
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r 


NAME 

gwtab  —  Write  to  the  lookup  table 
USAGE 

status  =  gwtab(area.  utabi  start,  rival); 

The  parameters  are: 

area  —  The  buffer  used  in  the  g op en  call 

utab  —  The  user's  integer  buffer  containing  the  values 
to  be  written  out 

start  —  Where  in  the  lookup  table  to  start 
nval  —  The  number  of  values  to  write  out 
VALUE  RETURNED 
zero  —  no  error 

nonzero  —  some  error  condition  was  detected  (operation  not  done) 
DESCRIPTION 

Gwtab  is  used  to  change  the  values  in  the  hardware  lookup  table. 
The  values  to  be  placed  in  the  lookup  table  should  be  between  0 
and  4095.  As  many  as  4096  values  O’*  as  few  as  one  value  may  be 
placed  in  the  table  starting  at  location  start  and  continuing  for 
all  nva 1  values. 

EXAMPLE 

int  abuf f er C 163.  mytabC40963.  i; 


i  ■  g op en ( abuf f er .  0.  0.  512.  512); 

f or ( i=0; i<4096; i++)  mytabLil  =  4095  -  i; 
i  =  gwtab ( ab uff er .  mytab.  0.  4096); 

This  will  fill  the  lookup  table  locations  0  ->  4095  with  the 

values  4095  ->  0  <i.  e.  .  the  output  is  the  inverse  of  the  input). 
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NAME 

grrow - Read  in  a  row  from  a  window 

USAGE 

status  =  grrow(area.  rbuf,  mum,  rstarti  npts,  inc); 

The  parameters  are: 

area  —  The  buffer  used  in  the  aopen  call 

rbuf  —  The  user's  integer  array  to  receive  the  values 
to  be  read  in 

mum  —  The  row  to  be  read  in  (relative  to  the  bottom  of 
the  window) 

rstart  —  The  column  to  start  reading  from  (relative 
to  the  left  of  the  window) 

npts  —  The  number  of  points  to  read  in 

inc  —  The  distance  (and  direction)  between  points 

VALUE  RETURNED 

zero  —  no  error 

nonzero  —  some  error  condition  was  detected  (operation  not  done) 
DESCRIPTION 

Grr ow  is  used  to  read  in  a  row  from  the  user's  window.  The  values 
from  the  row  specified  are  transferred  from  the  display  and  sent 
directly  to  the  user's  row  buffer.  The  column  to  start  reading 
from  and  the  number  of  points  to  read  in  are  also  specified  in 
the  call.  The  inc  parameter  is  used  to  read  in  pixels  which  are  a 
set  distance  apart.  If  inc  is  negative  the  pixels  are  read  back 
from  right  to  left  from  the  display.  It  is  the  user's 
responsibility  to  make  sure  that  the  number  of  points  to  be  read 
in  will  not  violate  the  window's  boundary.  If  too  many  points  are 
requested  an  error  condition  will  be  returned  and  the  operation 
will  not  be  done. 

EXAMPLE 

int  abufferC163,  thisrowC643,  somewhere; 


i  =  gopen(abuffer.  23,  46.  64,  64);  /*  A  64  by  64  window  */ 


l  f  (  grr  ow(  ab  uf  f  er ,  thisrow,  somewhere,  0,  64,  1))  -C 

printf( "ERROR  ON  ROW  READ\n " > ; 
e  x  i  t  (  )  ; 

> 

This  will  read  in  64  values  to  thisrow  from  the  row  somewhere. 
Furthermore,  the  input  will  start  from  the  first  column  and  the 
pixels  will  be  next  to  each  other. 
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NAME 


grc  o  1  - 

- Read 

in  a  column 

from  a  window 

USAGE 

status 

=  grcol(area,  cbuf. 

cnum,  cstart,  npts.  inc); 

The  parameters 

are  : 

area  — 

-  The  buffer 

used  in  the  aooen  call 

cbuf  — 

-  The  user's 
to  be  read 

integer  array  to  receive 
i  n 

the  values 

cnum  — 

-  The  column  to  be  read  in  (relative 
of  the  window) 

to  the  left 

c  start 

—  The  row  to  start  reading  from 
the  bottom  of  the  window) 

(relative  to 

npts  — 

-  The  number 

of  points  to  read  in 

inc  — 

The  distance 

(and  direction)  between  points 

VALUE  RETURNED 


zero  —  no  error 

nonzero  —  some  error  condition  was  detected  (operation  not  done) 
DESCRIPTION 

Gr c o 1  is  used  to  read  in  a  column  from  the  user's  window.  The 
values  from  the  column  specified  are  transferred  from  the  display 
and  sent  directly  to  the  user's  column  buffer.  The  row  to  start 
reading  from  and  the  number  of  points  to  read  in  are  also 
specified  in  the  call.  The  i nc  parameter  is  used  to  read  in 
pixels  which  are  a  set  distance  apart.  If  inc  is  negative  the 
pixels  are  read  back  from  top  to  bottom  from  the  display.  It  is 
the  user's  responsibility  to  make  sure  that  the  number  of  points 
to  be  read  in  will  not  violate  the  window's  boundary.  If  too  many 
points  are  requested  an  error  condition  will  be  returned  and  the 
operation  will  not  be  done. 

EXAMPLE 

int  abufferC163,  thiscolC643,  somewhere; 


i  =  gopen<abuf f er.  23i  46,  64,  64);  /*  A  64  by  64  window  */ 


i f < g rr ow ( ab uf f er i  thiscol,  somewhere.  0.  64,  1))  < 

printf< "ERROR  ON  COLUMN  READ\n " ) ; 
e  x  i  t  (  ) ; 

> 

This  will  read  in  64  values  to  th  i  sc  o  1  from  the  column  somewh  ere. 
Furthermore,  the  input  will  start  from  the  first  row  and  the 
pixels  will  be  next  to  each  other. 
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NAME 

grpnt  -  Read  in  a  point  from  a  window 

USAGE 

pntval  =  grpnt(areai  cnum,  rnum);  /*  Returns  the  point  */ 

The  parameters  are: 

area  —  The  buffer  used  in  the  a  op  en  call 

cnum  —  The  window— relative  column  position  of  the  point 
rnum  —  The  window-relative  row  position  of  the  point 
VALUE  RETURNED 

nonnegative  —  no  error,  point  value  returned 

negative  —  some  error  condition  was  detected  (nothing  done) 
DESCRIPTION 

Gront  is  used  to  read  in  one  point  from  the  column  and  row  of  the 
user's  window  as  specified  in  the  call.  The  value  of  the 
function,  if  no  error  has  occurred,  will  be  from  0  to  4095.  With 
this  function,  points  may  be  read  back  in  any  order  or  direction 
one  at  a  time. 

EXAMPLE 

int  abuf ferC 161; 
int  pntval,  x,  y; 


i  ■  gopen  (abuf  f  er,  23,  46,  64  64); 


pntval  *  grpnt (abuf fer,  x,  y>; 
if(pntval  <  0)  -C 

printf("Neg  value  from  grpnt\n")> 
e  x  i  t  (  ) ; 


This  will  read  in  the  value  at  column  x.  and  row  y.. 
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NAME 

grcur  —  Read  in  the  positions  of  the  cursors 
USAGE 

status  =  grcur(area<  curbuf,  asynch); 

The  parameters  are: 

area  —  The  buffer  used  in  the  a  op  en  call 

curbuf  —  A  four  integer  buffer  to  receive  the  cursor 
positions 

asynch  —  If  nonzero#  an  asynchronous  cursor  read  is  done 
VALUE  RETURNED 
zero  —  no  error 

nonzero  —  some  error  condition  was  detected  (operation  not  done) 
DESCRIPTION 

Grcur  is  used  to  read  back  the  absolute  (x,y)  coordinates  of  the 
two  cursors  into  the  user's  buffer  in  the  order  ( x 1# y 1.  x2, y2) .  If 
the  asunc h  parameter  is  nonzero#  grcur  will  not  return  until:  (1) 
The  track  ball  is  moved  and  the  TRACK  switch  is  on,  or,  (2)  The 
ENTER  button  is  pushed.  This  mode  is  quite  useful  when  a  user 
tries  to  track  a  changing  cursor  position.  It  also  lowers  the 
load  on  the  operating  system.  If  asunc h  is  zero#  the  cursor 
positions  will  be  immediately  returned.  Note  that  the  positions 
returned  are  absolute,  not  relative  to  the  user's  window. 

EXAMPLE 

int  abufferC161#  cursorsC4], 


i  =  gop en ( abuf f er #  23#  46#  64#  64); 


i  f  (  grcur  ( abuffer,  cursors#  1))  -C 

pr intf < "Somebody  blew  it!\n")» 
e  x  i  t  (  )  # 

> 

This  will  read  in  the  absolute  GRINNELL  coordinates  of  the  two 
cursors  into  the  user's  buffer  cursors.  The  function  will  wait 
until  the  track  ball  has  been  moved  or  the  ENTER  button  has  been 
pushed. 
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NAME 

grtab  —  Read  in  the  lookup  table 


USAGE 

status  =  grtab(area<  utab/  start/  nval); 

The  parameters  are: 

area  —  The  buffer  used  in  the  a  oo  en  call 

utab  —  The  user's  integer  buffer  to  receive  the  values 
to  be  read  out 

start  —  Where  in  the  lookup  table  to  start 
nval  —  The  number  of  values  to  read  in 


VALUE  RETURNED 
zero  —  no  error 

nonzero  —  some  error  condition  mas  detected  (operation  not  done) 
DESCRIPTION 

Grtab  is  used  to  read  in  the  values  from  the  hardware  lookup 
table.  The  values  to  be  placed  in  the  user's  buffer  will  be 
between  0  and  4095.  As  many  as  4096  values  or  as  few  as  one  value 
may  be  read  from  the  table  starting  at  location  star t  and 
continuing  for  all  nval  values. 

EXAMPLE 

int  abufferC161.  mytabC40961<  i; 


i  =  gopen < abuf f er<  0#  0/  513/  512); 


i  f  (  grtab  <  abuffer,  mytab.  0<  4096))  -C 

pr i nt f ( "Cou Idn  '  t  read  the  lookup  table\n"); 
e  x  i  t  (  )  i 

> 

This  will  copy  the  entire  lookup  table  into  the  user's  buffer 
mutab 
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NAME 

gcam  —  Input  an  image  from  the  T. V.  camera 
USAGE 

status  =  gcam<area(  nfrms<  shift); 

The  parameters  are: 

area  —  The  buffer  used  in  the  oopen  call 

nfrms  —  The  number  of  frames  to  sum  (nfrms  <  256) 

shift  —  The  amount  to  shift  each  frame  before  summing 
(shift  should  be  from  0  to  7) 


VALUE  RETURNED 
zero  —  no  error 

nonzero  —  Some  error  condition  was  detected  (operation  not  done) 
DESCRIPTION 

Gcam  is  used  to  input  images  into  the  GRINNELL  display  memories 
Using  the  nfrms  and  sh i f t  parameters  a  user  can  average  as  many 
as  64  consecutive  frames  (up  to  255  can  be  summed).  Single 
frames  with  no  shift  are  input  by  setting  nfrms  to  zero 

EXAMPLE 

int  abuf f er C 161; 


i  =  gopen(abuf fer.  0#  0,  512#  512);  /*  NOTE  —  Single  User  */ 


if (gcam(abuffer,  64#  6))  -C 

pr intf ( "Cou 1 dn  '  t  input  from  camera\n"); 
ex i t (  )  > 

> 

This  will  input  and  average  sixty  four  frames  from  the  camera. 
That  is.  each  of  64  frames  will  be  input#  downshifted  6  bits 
(divided  by  64)  and  added  to  the  previous  sum. 
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NAME 

gscrl  —  Scroll  the  image 
USAGE 

status  =  gscrl  (area/  num>  updown); 

The  parameters  are: 

area  —  The  buffer  used  in  the  a  op  en  call 
num  —  The  number  of  rows  to  scroll 

updown  —  Scroll  up  or  scroll  down  (zero,  nonzero) 
DESCRIPTION 

Gscrl  is  used  to  scroll  the  display  up  or  down.  As  many  as  512 
rows  may  be  scrolled  at  one  time.  Scrolling  the  image  could  be 
used  when  a  continuous  strip  display  is  wanted. 

EXAMPLE 

int  abuf f erC 163,  rowC5123; 


i  =  g op en ( ab uf f er ,  0,  0,  512,  512), 


l f < g scr 1 ( ab uf f er ,  1,  0))  < 

pr intf  < "NO  SCROLLNn " ) , 
e  x  i  t  (  ) ; 

> 

i  =  guirowfabuffer,  row,  0,  0,  512,  1); 

This  user  scrolls  the  image  up  one  row,  then  overwrites  the  first 
row,  making  a  continuously  upwards  moving  strip. 


OCOLDR 


GCOLOR 


NAME 

gcolor  —  Turn  color  mode  on  and  off 
USAGE 

status  =  gcolor(area,  flag); 

The  parameters  are: 

area  —  The  buffer  used  in  the  q op en  call 
flag  —  Used  to  change  the  mode 
VALUE  RETURNED 
iero  —  no  error 

nonzero  —  Some  error  condition  was  detected  (operation  not  done) 
DESCRIPTION 

Gcolor  is  used  to  change  the  display  from  color  to  black  and 
white  and  back  again.  If  flag  is  zero,  the  display  will  be  color 
If  it  is  nonzero  the  displ-ay  will  be  black  and  white. 

EXAMPLE 

int  abufferC163; 


i  *  gop en < abuf f er ,  0.  0,  512,  512) ; 


i f ( g c o 1  or ( ab uf f er ,  1 )  )  < 

printf("No  color  change  a  1 1  owed ! \n " > ; 
ex i t (  ) ; 

> 

This  will  change  the  displayed  image  to  black  and  white. 


BTUEF2 

(Mi  see  I  Igneous) 
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B INOP (VII) 


NAME 

binop  -  applies  binary  operation  between  two  pictures. 
SYNOPSIS 

#include  " binop.  t‘‘ 

DESCRIPTION 

B inoo  contains  the  C  source  for  a  driver  program  which  ap¬ 
plies  a  point-wise  binary  operation  between  two  picture 
files  with  GAP  style  headers.  To  construct  a  program: 

#include  "defns.  t" 
ttinclude  "binop.  t" 
char  binop(  p<  q  )  char  p» 

<  .  .  .  function  for  computing  pointwise  binary  opera¬ 
tion.  .  .  > 


The  first  file  is  read  from  standard  input<  the  second  from 
the  file  argument  given  on  the  call/  EXCEPT  that  if  the  file 
argument  is  prefixed  immediately  with  a  hyphen  ("-")/  the 
order  of  the  files  is  reversed  when  applying  the  binary 
operator.  The  result  picture  is  written  to  standard  output. 


FILES 

binop.  t  -  C  source  for  driver 
defns.  t  -  useful  definitions 

DIAGNOSTICS 

"File  argument  needed!" 

"Can't  open  file  argument!" 

"First  file  not  a  byte  per  pixel  file!" 

"Second  file  not  a  byte  per  pixel  file!" 

"Picture  files  don't  match!"  -  not  the  same  size 
"Premature  end  on  first  file!" 

"Premature  end  on  second  file!" 

"Excess  data  remaining  on  first  file!" 

"Excess  data  remaining  on  second  file!" 

In  the  above/  "first  file"  normally  means  standard  input/ 
and  "second  file"  the  file  given  as  argument/  but  these 
roles  are  reversed  if  the  "-"  prefix  is  used  on  the  file  ai — 
g  ument. 

AUTHOR 

Les  Kitchen 

SEE  ALSO 

euc(VI)/  max(VI),  dirn(VI)/  unop(VII),  local(VII) 


BUGS 

Only  works  for  .one  byte  per  pixel  files. 

Read  error  will  also  cause  "Premature  end.  .  .  "  message. 

Should  have  a  facility  for  getting  parameters/  like 
local (VI I ) . 


ERRPRNT (VII)  6-Sept ember- 1979  ERRPRNT(VII) 


NAME 

errprnt  -  print  error  message  and  exit 
SYNOPSIS 

char  *argvO  0;  /*  copy  Oth  parameter  -  program's  name  */ 
main(argcj  argv) 
char  **argv» 

< 

argvO  =  argvCOIi 


errprnt ( comstr.  arg)j 
char  *comstr; 

DESCRIPTION 

Errprnt  is  a  subroutine  that  printf's  the  calling  program's 
name  and  a  user  supplied  command  string  that  may  use  an  op¬ 
tional  second  argument.  Errprnt  sends  to  the  diagnostic 
file  2  that  is  normally  the  user's  tty. 

The  calling  program's  name  is  supplied  through  the  commom 
variable  aravO  that  should  be  set  equal  to  the  calling  pro¬ 
grams  argument  0  by  the  main  routine.  The  user  supplied 
command  string  comstr  may  use  one  single  word  optional 
second  parameter  aro  such  as  a  string  pointer  or  an  integer. 
After  printing  comstr.  errornt  prints  a  carriage  return  and 
exits  back  to  the  operating  system  using  return  code  1. 

Versions  are  available  for  both  the  standard  printf  or  the 
portable  C  library  version. 

DIAGNOSTICS 

If  argvO  is  not  defined  in  the  main  program.  ld(I>  com- 
p  lains. 


FILES 
SEE  ALSO 

readrow( VI I ) .  printf(III).  exec(II).  ld(I) 
AUTHOR 

Robert  L.  Kirby 

BUGS 


1 
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FONT( III) 


NAME 

openfont.  closefont,  readchar>  freechar.  accesschar.  height, 
u/idth.  r_width.  baseline,  name.  code,  leftadj  -  font  input 
routines 

USEAGE 

cc  <program>  -IF 

SYNOPSIS 

int  fd; 

char  *name> 

fd  =  openfont ( name > ; 

char  *name 
closefontf name ) ; 

int  fd.  cd; 
char  c; 

cd  =  readchar(fd<  c) 

int  cdi 
freechar (cd). 

int  pixel,  cd.  x<  y; 

pixel  *  accesschar ( cd*  x.  y); 

int  cd.  high; 
high  =  heigh t(cd) 

int  cd.  wide; 
wide  =  width ( cd ) 

int  cd.  ruiidi 
ruiid  =  r_uiidth(cd) 

int  cd.  base; 
base  =  baseline(cd) 

int  fdi 
char  *nam< 
nam  =  name<fd) 

int  cd.  cod; 
cod  =  code(cd) 

int  cd.  left; 
left  =  leftadj(cd) 


DESCRIPTION 

These  routines  read  and  access  characters  from  font 
files.  Qpenf ont  and  readchar  call  the  library  routine  alloc 
to  reserve  space  for  their  respective  descriptors.  and  re¬ 
turn  a  pointer  to  the  descriptor.  Closef ont  and  freechar 
clean  up  and  then  free  space  used  by  the  descriptor.  This 
is  NOT  the  same  as  doing:  f ree < descr i p tor )  directly.  The 
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actual  manipulate  on  of  the  descriptors  should  be  handled 
onl u  by  these  subroutines. 

Qoenf ont  will  first  examine  the  current  directory  for 
the  named  font<  then  the  system  font  library.  It  will  then 
append  the  ".  fnt“  suffix  if  necessary.  The  descriptor  it  re¬ 
turns  is  used  by  c losef ont.  and  basel ine.  A  -1  return  indi¬ 
cates  that  the  named  font  file  does  not  exist  or  is  inacces¬ 
sible. 

Closef ont  closes  the  actual  file  descriptor  and  frees 
the  font  descriptor. 

Readchar  is  given  a  font  descriptor  and  an  ASCII  charac¬ 
ter.  It  will  allocate  core  space  for  the  character's  raster 
pattern  and  read  it  in  from  the  font  file  indicated  by  the 
descriptor.  The  descriptor  it  returns  is  used  by  accesschar 
and  freechar. 

Accesschar  returns  a  0  or  1  for  any  single  pixel  of  the 
character's  raster  pattern.  A  -1  indicates  an  attempt  to 
access  a  pixel  beyond  the  limits  of  the  raster. 

Freechar  releases  the  core  space  occupied  by  the  charac¬ 
ter.  This  is  NOT  equivalent  to  calling  the  library  routine 
free. 


Name  must  be  passed  a  font  descriptor.  It  returns  a 
pointer  to  the  name  of  the  font. 

Height  and  basel ine  may  be  passed  a  font  descriptor  or.  a 
character  descriptor.  They  return  the  height/baseline  of  the 
f ont/character . 

Width,  r  width,  code  and  1 ef tad  i  accept  only  a  character 
descriptor.  Width  returns  the  width  of  the  character. 
r  width  returns  the  width  of  the  character's  raster  (which 
may  be  greater  than  the  defined  width  of  the  character  — 
meaning  that  the  character  overlaps  to  the  right),  code  re¬ 
turns  the  ASCII  code  for  the  character,  and  1 ef tad  i  returns 
the  number  of  pixels  by  which  the  character  should  overlap 
the  character  to  its  left. 

AUTHOR 

Fred  Blonder 

FILES 

/lib/libF.  a  -  library  where  these  routines  live 
/b/fonts  -  system  font  library 


SEE  ALSO 

FONT (V ) 


FONT (111) 
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DIAGNOSTICS 

Several/  from  all  the  routines.  They  should  be  self  explana¬ 
tory/  and  are  written  to  the  error  output.  When  they  occur 
the  routine  detecting  it  will  always  return  -1. 

BUGS 

Error  checking  is  not  rigorous.  Obvious  errors  such  as  pass¬ 
ing  the  wrong  type  of  descriptor  are  caught/  but  not  every 
possible  combination  of  invalid  parameters  is  tested  for. 
Since  the  descriptors  returned  by  the  routines  are  pointers 
to  structures/  using  them  as  pointers  yourself  could  result 
in  the  structures  being  trashed/  causing  these  routines  to 
bomb  the  next  time  th'ey  are  called. 
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NAME 

font  -  font  file  format 
DESCRIPTION 

The  format  of  the  font  files  used  by  pod  is  as  follows.  The 
first  512  bytes  are  128  two  word  entries  for  the  characters, 
(numbered  0  -  127)  in  each  entry.  The  first  word  is  the  to¬ 
tal  character  width>  including  any  white  space.  The  second 
word  is  the  address  of  the  character's  definition  farther  on 
in  the  file. 

Starting  at  byte  512  there  are: 

The  font  height  in  pixels.  (1  word) 

The  distance  of  the  font's  baseline  from  the  top  of  the 
font.  (1  word) 

A  null  terminated  ASCII  string  containing  descriptive 
information  about  the  font. 

The  character  definitions  begin  at  byte  768.  Each  one  con¬ 
sists  of  the  following  one  word  fields,  and  the  raster  pat¬ 
tern. 


Character  code:  Essentially  a  pointer  back  into  the  in¬ 
dex  table  at  the  beginning  of  the  file. 

Raster  width:  The  number  of  pixels  in  one  row  of  the 
character's  raster  pattern. 

Raster  length:  The  number  of  pixels  in  one  column  of 
the  character's  raster  pattern. 

Left  overlap  of  the  previous  character. 

Rows  from  top:  The  number  of  pixels  at  the  top  of  the 
character  that  are  left  blank,  i. e.  the  vertical 
offset  of  the  raster  pattern. 

The  size  of  the  raster  pattern  in  bytes. 

The  raster  pattern:  The  pixels  of  the  raster  are  stored 
starting  with  the  upper  left  hand  pixel  and 
proceeding  to  the  right  across  each  row.  Each 
group  of  eight  pixels  is  stored  in  one  byte,  from 
the  high-order  to  the  low-order  bits.  If  a  row  of 
the  raster  does  not  fit  into  a  group  of  bytes 
evenly,  the  next  row  begins  in  the  same  byte.  On¬ 
ly  the  last  byte  of  the  raster  is  padded  with 
unused  bits. 
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The  files  look  like  this: 


!  Character  #1 

!  Character  #2  i 

.  .  !  Character  #128! 

!  Char 
!  Width 

1  Char 
!  Ptr 

■'  Char 
!  Width 

i  Char  ! 

!  Ptr  ! 

- y - y - 

.  .  !  Char  !  Char  1 

!  Width  !  Ptr  ! 

m 

0  1 

2  3 

4  5 

6  7 

508  509  510  511 

1 

1 

Description  - 

> 

!  Font  !  Font  e! 

F  !  0  !  0  !  B 

!  A  !  R  !\0  ! 

!  Heigh t ! Base  1 in ! 

A  A 

1  1  1 

l  1  1 

A  A 

!  !  !  ! 

512  etc.  -> 

!  Raster  -> 

- v - - v - v - v - v - - — v - v - 

i  Char  !  Raster!  Raster!  Left  iRows  F-!  Raster!  !  !. 

!  Code  !  Width  !  Height {Overlap  iron  Top!  Size  !  !  ! 

—  —  -|  —  .  II _ .  - - - _  _ 

768  etc.  -> 


AUTHOR 

File  format  designed  by  Lee  Moore.  Documented  by  Fred 
Blander. 


FILES 

/I ib/f onts/*. fnt  -  system  font  library 
SEE  ALSO 

pgp  ( I )  •  descfnt  (I) 
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NAME 

local  -  applies  local  operation  to  a  picture 
SYNOPSIS 

^include  "local,  t" 


DESCRIPTION 

Local  contains  the  C  source  for  a  driver  program  which  ap 
plies  a  local  operation  to  a  picture  file  with  GAP  style 
reader.  To  construct  a  program: 


(o)  fcinclude  “defrs.t"  (important  definitions). 

(i)  #define  the  following  constants 

G_HEIGHT  the  vertical  height  of  the  local  operator 
in  pixels; 

0_WIDTH  the  horizontal  width  of  the  local  operator 
in  pixels; 

Q_BAKGND  the  background  filler  value  for  border  points 
where  the  operator  can't  fit  (typically  zero); 
0_X_CNTR  St  Q_Y_CNTR  the  x  y  co-ordinates  of  the  “center" 
of  the  operator  (the  output  of  the  operator  is 
stored  at  the  point  in  the  output  picture  which 
corresponds  to  the  center*. 

N. B.  All  co-ordinates  are  strictly  Cartesian:  The  x  co-ordinate 
increases  from  zero-  left  to  right  across  the  picture;  and  the  y 
co-ordinate  from  zero-  bottom  to  top.  The  picture  is  stored  on 
file  by  rows-  with  the  first  row  (y=0)  at  the  bottom  of  the  picture. 

(ii)  Declare  global  variables  for  storing  operator  parameters 

(iii)  Include  a  procedure: 

qatparst  argc-  argv  )  int  argc;  char  *ar g vC  3 ; 
f setting  of  the  above  global  variables  from  the  command 
line  (using  standard  conventions  for  argc  S<  argv). 

(iv)  Include  a  function: 

char  1  oc a  1  op  (  nbd  )  char  *rb'dt  Q_HEIGHT  3; 
which  returns  the  result  of  the  local  operator.  Using 
zero-origin  Cartesian  co-ordinates-  relative  to  the 
neighborhood,  the  point  (x»y)  can  be  accessed  as 
nbdCy3Cx3  inside  localop. 

(v)  #include  " local,  t " 

The  program  reads  the  input  picture  from  standard  input  and 
writes  the  result  to  standard  output.  Both  input  and  result 
pictures  have  the  same  size. 


FILES 

1  o  c 
d  e  f 


C  source  for  driver 
useful  aefinitions 
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D I AGNGST I C  5 

’’Input  not  a  byte  per  pixel  picture  file'"  -  header  not 
right 

"Input  picture  too  email  for  operator!"  -  picture  smaller 
than  neighborhood 

"Premature  end  of  input!"  -  picture  smaller  than  expected 
from  header 

"Excess  input  data  remaining!"  -  picture  larger  than  expect¬ 
ed  from  header 


AUTHOR 

Las  Ki tc n en 


SEE  ALSO 

sobel(VI)j  unop(VII),  binop(VII) 


BUGS 

Only  works  for  one  byte  per  pixel  files 

Read  error  will  also  cause  "Premature  end. . . "  message. 
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READROW (VI I) 


NAME 

readrow  -  read  fixed  length  row  in  spite  of  pipe  shortchang¬ 
ing 

SYNOPSIS 

readrou < buf f er,  length) 
char  *buffer* 
int  length* 

DESCRIPTION 

Readr oin  is  a  subroutine  that  fills  buffer  u/ith  length  bytes 
from  the  standard  input  regardless  of  the  actual  input  file 
type.  Thus  when  reading  images  or  matrices*  readr ow  can  get 
an  entire  row  regardless  of  any  pipe  shortchanging.  Readrow 
returns  the  number  of  bytes  it  was  unable  to  read  because  an 
end  of  file  was  found.  In  many  cases*  if  the  number  re¬ 
turned  at  the  end  of  the  file  is  not  the  number  of  bytes  re¬ 
quested  then  the  data  length  is  incorrect. 

Readrow  uses  errornt  to  notify  the  user  of  read  errors. 
Errornt  expects  the  calling  program's  name  to  be  supplied 
through  the  commom  variable  aravO  that  should  be  set  equal 
to  the  calling  programs  argument  0  by  the  main  routine. 

Readrow  provides  economical  raster  input  for  programs  that 
only  use  one  input  file.  Using  operating  system  support*  a 
program  can  be  written  as  a  filter  that  avoids  using  ir- 
■  relevant  workspaces  or  setup  routines.  For  many  image  pro¬ 
cessing  applications*  all  input  may  be  handled  by  readrow 
alone. 

DIAGNOSTICS 

On  physical  data  errors*  readrow  prints  ''read  error''  and 
exits.  If  aravO  is  not  defined  in  the  main  program.  ld(I) 
complains. 

FILES 
SEE  ALSO 

errprnt ( VI I ) »  printf(III).  exec(II).  ld(I) 

AUTHOR 

Robert  L.  Kirby 

BUGS 


Only  the  standard  input  may  be  read. 
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NANE 

jnop  -  applies  unary  operation  to  a  picture. 
S  yi'iQpg  1 3 

(♦include  "unop.  t  “ 


DESCRIPTION 

Ur  op  contains  the  C  source  for  a  driver  program  which  ap¬ 
plies  a  point-wise  unary  operation  to  a  picture  file  with 
GAP  style  headers.  To  construct  a  program: 

^include  " d e f n s .  t " 

#inc lude  "unop.  t " 

char  unop  (  p  )  char  pi 

■C  .  .  .  function  for  computing  pointwise  unary  opera¬ 
tion.  .  > 


The  input  picture  is  read  from  standard  input.  The  result 
picture  is  written  to  standard  output.  Can  be  used  for  mak¬ 
ing  filters 


~  ILtS 

unop.  t  -  C  source  for  driver 
defns.  t  -  useful  definitions 

DIAGNOSTICS 

"Input  not  a  byte  per  pixel  file1"  -  header  not  right 
"Premature  end  of  input!"  -  picture  smaller  than  expected 
from  header 

"Excess  input  data  remaining1"  -  picture  larger  than  expect¬ 
ed  from  header 

AUTHOR 

Le  s  Kitchen 


SEE  ALSO 

a  o  s ( V I ) ,  Pinop(VlI),  local (VII) 


BUGS 

Only  works  for  one  byte  per  pixel  files 
Read  error  will  also  cause  "Premature  end.  .  "  message 
Should  have  a  facility  for  getting  parameters, 
local  (VII  > 


like 
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NAME 

abs  -  takes  absolute  value  of  a  picture  file. 

SYNOPSIS 

abs 

DESCRIPTION 

Ab s  reads  a  picture  file  with  GAP  style  header  from  standard 
input,  takes  the  absolute  value  of  every  pixel,  and  writes 
the  resulting  picture  file  to  standard  output.  May  be  used 
as  a  filter. 


FILES 

abs. c  -  C  source  code 

unop.  t  -  driver  program  for  unary  picture  operators  in  gen¬ 
eral 

defns.  t  -  useful  definitions 
DIAGNOSTICS 

"Input  picture  not  a  byte  per  pixel  file!" 

-  header  byte  count  not  one 
"Premature  end  of  input!" 

-  picture  smaller  than  expected  from  sire  given  in 
header 

"Excess  input  data  remaining!" 

-  picture  bigger  than  expected  from  size  in  header 

AUTHOR 

Les  Kitchen 

SEE  ALSO 

unop  (VII)' 


BUGS 

Works  only  for  1  byte  per  pixel  files. 

Read  error  will  also  cause  "Premature  end  of  input!"  mes¬ 
sage. 
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NAME 

biglet  -  print  big  letters  using  fonts 
SYNOPSIS 

biglet  <fontname> 

DESCRIPTION 

Bio  let  reads  text  from  the  standard  input<  using  it  to 
select  characters  from  <f on tname>  which  are  written  to  the 
standard  output  sideways*  like  this: 


** 

****  * 

******  ** 

**  **  ** 
**  *  ** 

**  **  ** 

**  **  ** 

**  **  *** 


********** 

********* 

** 


* 

** 

*************** 

*************** 


** 

** 

** 

** 

** 

** 

** 

** 

*** 

*** 

********* 

******* 


Linefeeds  in  the  input  text  are  ignored*  they  will  not 
produce  spaces.  Control  characters  may  be  entered  by  typing 
a  before  the  appropriate  letter.  i.  e.  :  '  '  ‘/.a '  '  for 

control-a. 

Biolet  precedes  each  line  of  output  with  a 
control-' ' F ' '»  which  will  put  the  Printronix  into  S-lpi  mode 
so  that  the  raster  pattern  is  more  square  than  it  would  be 
otherwise. 

AUTHOR 

Fred  Blonder 

FILES 

<fontname>.  fnt  -  the  specified  font  file 


SEE  ALSO 

DESCENT ( I ) »  TITLE(I).  PGP(I).  FONT<III),  FONT ( V) 

DIAGNOSTICS 

.  .  .  are  given  -for  an  unknown  font,  or  a  character  that  is 

not  defined  in  the  specified  font. 


BUGS 
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NAME 

calib  -  University  of  Maryland  Computer  Vision  Laboratory 
scanner  calibration  routine 


SYNOPSIS 

calib 


DESCRIPTION 


Calib  is 
p icture 
memory. 
columns 
switches 
used  to 
be  made, 
controls 


used  to  calibrate  the  scanner, 
and  send  it  out  over  the 
The  scanner  should  be  online  wi 
switches  should  be  set  to 
should  be  set  to  376  (octal), 
adjust  the  focus  and  gray  seal 
It  should  be  compared  with  th 
adjusted  accordingly. 


It  will  construct  a 
interface  to  the  scan 
th  the  PDP11/45.  The 
375  (octal).  The  rows 
The  image  sent  is 
e  of  the  Polaroids  to 
e  standard  and  the 


FILES 

/dev/rdrO 

SEE  ALSO 

dr  (IV) 


A 


-  i  - 


COLOR,  GRAY 


COLOR,  GRAY 


NAME 

color  -  Turn  on  color  display  mode 
gray  -  Turn  off  color  display  mode 


DESCRIPTION 

Color  and  arau  are  used  to  switch  the  display  back  and  forth 
between  color  and  black  and  white  mode.  They  do  not  in  any  way 
affect  the  stored  data  and  may  be  used  at  any  time  (even  if  some¬ 
one  else  is  using  the  display).  It  should  be  noted  that  the  Grin- 
nell  has  a  possible  range  of  256  graylevels,  so  4  bits/pixel  are 
not  displayed  when  color  mode  is  off. 


USAGE 

color 

gray 


EXAMPLE 
'A  color 

-CTurn  on  color  mode> 

'A  gray 

•CTurn  off  color  mode> 


AUTHOR 
Russ  Smith 


A 


CM<VI) 


June  1979 


CM(  VI ) 


NAME 

cm  -  find  central  moments  of  a  shape 

SYNOPSIS 

cm  pic  Cl  J1 

DESCRIPTION 

pic  64  x  64  binary  GAP  picture 

I, J  specifies  particular  central  moment 

cm  finds  the  I<J  central  moments  of  the  shape  contained  in 
the  picture.  If  I  and  J  are  not  specified,  the 

II, 02,20,21,12  central  moments  and  the  area  of  the  shape  are 
found. 

FILES 

DIAGNOSTICS 

a  feu,  all  are  clear  and  self-explanatory. 

AUTHOR 

Sanjay  Ranade 

SEE  ALSO 

qcm<V) 

BUGS 


1 


i 


CSIZE<VI ) 


August  1979 


CSIZE( VI ) 


NAME 

csize  -  changes  a  picture's  pixel  size 

SYNOPSIS 

csize  Cnewsizel 


DESCRIPTION 

newsize  news i z e  is  the  picture's  new  pixel  size 

Csize  reads  a  picture's  header  from  the  standard  input  file 
and  changes  the  fifth  word  of  the  header  (i.e. ,  the 
picture's  pixel  size)  to  newsize.  The  new  header  is  then 
written  to  the  standard  output  file.  If  newsize  is  not 
given,  the  header  is  unchanged.  Csize  then  reads  an  integer 
picture  of  dimension  NROW  rows  by  NCOL  columns,  where  NROW 
is  the  number  of  rows  in  the  input  picture  and  NCOL  is  the 
number  of  columns  in  the  input  picture,  from  the  standard 
input  and  writes  it  to  the  standard  output  file. 


FILES 


DIAGNOSTICS 

"Header  not  read" 

"Picture  width  too  large" 

"Illegal  size" 

"Too  much  data,  row  count  expired" 
"Unexpected  EOF  encountered" 
"Input  pipe  not  empty" 


first  12  bytes  of  picture 
not  read 

#  of  columns  in  input 
picture  exceeds  input 
buffer  length 

newsi ze  <  1  or 
news i z e  >  5 

#  of  rows  in  picture  ex¬ 
ceeded 

Eof  encountered  before 
picture  completed 
data  still  resides  in  in¬ 
put  pipe 


AUTHOR 

Philip  A.  Dondes 

SEE  ALSO 

PACK (VI ) 

UNPACK < VI ) 


BUGS 


DESCFNT ( I ) 


4-July-1979 


DESCFNT ( I ) 


NAME 

descent  -  describe  the  contents  of  a  font  file 
SYNOPSIS 

descfnt  <fontname>  C  <samp le— character>  3 
DESCRIPTION 

Desc f nt  has  two  modes:  If  it  is  invoked  with  one  argu¬ 
ment  it  reads  the  font  file  named  by  the  argument*  lists  all 
the  ASCII  characters  which  are  defined  in  the  font.  and 
prints  the  descriptive  information  stored  in  the  font  file. 
If  it  is  invoked  with  two  arguments  it  takes  the  first  one 
as  a  font  name  —  as  before  —  and  displays  the  raster  of 
the  font  character  corresponding  to  the  second  argument.  in 
this  form: 


**************** 

**************** 

**************** 

*** 

*** 

*** 

*** 

*** 

*************** 

*************** 

*************** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 

*** 


AUTHOR 

Fred  Blonder 

FILES 

<fontname>. fnt 
SEE  ALSO 

BICLET(I),  TITLE(I).  PCP(I>,  FONT<III).  FONT(V) 

DIAGNOSTICS 

.  .  .  are  given  for  an  unknown  font,  or  a  character  that  is 

not  defined  in  the  specified  font. 


> 


DIFFOP ( VI ) 


May  1979 


DIFFOP ( VI ) 


NAME 

diffop  -  produce  a  difference  picture 
SYNOPSIS 

d i f f op  ifile  odirect  nsize  dir  EfcD  Efrl  Enel  Enr3 
DESCRIPTION 

ifile  input  picture  file  as  defined  by  CXAP 
odirect  directory  where  output  picture  will  be  created 
nsize  neighborhood  size  where  neighborhood  is  a  square 
region  2"vnsize  for  nsize  =  1.  2  and  3. 
dir  direction  for  difference  operation  where  direction 

=  1.  2.  3  and  4  refers  to  horizontal  vertical, 

right  diagonal  and  left  diagonal,  respectively, 
fc  first  column  of  input  picture 

fr  first  row  of  input  picture 

nc  number  of  columns  to  process  in  input  picture 

nr  number  of  rows  to  process  in  input  picture 

Pi f f oo  creates  a  difference  picture  for  a  given  direction. 
The  size  of  the  difference  neighborhood  may  be  2x2.  4x4  or 
8x8.  The  difference  operation  is  defined  to  be  the  sum  of 
the  A's  minus  the  sum  of  the  B's.  where  the  A's  and  the  B's 
are  depicted  below: 

Right  Left 


Horizontal 

Vertical 

Diagonal 

Diagonal 

AAAABBBB 

AAAA 

AAAA 

AAAA 

AAA*BBBB 

AAAA 

AAAA 

AAAA 

AAAABBBB 

AAAA 

AAAA 

AAAA 

AAAABBBB 

A*AA 

AAA* 

*AAAA 

BBBB 

BBBB 

BBBB 

BBBB 

BBBB 

BBBB 

BBBB 

BBBB 

BBBB 

BBBB 

BBBB 

BBBB 

where  the  *  represents  the  point  presently  being  considered. 
The  same  representation  holds  for  a  neighborhood  of  2x2  and 
8x8. 

A  single  CXAP  output  picture  is  created  for  each  execution 
of  d i f f op .  The  picture  name  will  be  "h",  "v",  "rd"  or  “Id" 

(depending  upon  the  direction)  residing  under  the  user 
specified  directory  "odirect." 

FILES 

Directory  p7140  exist  on  magnetic  tape  P7140  in  STP  format. 

/p7140/d i f f /d i f f op.  c  source  code  for  difference 

program  (includes  all  subpro¬ 
grams 

/mnt/ph i 1 /c xap . 1 i b  CXAP  library 
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DIFFQP  < VI ) 


May  1979 


DIFFOP(VI ) 


DIAGNOSTICS 


Header  error" 

error  in  attempt 
picture  header 

to 

read 

input 

Setupb  error" 

error  in  attempt 
picture 

to 

open 

input 

Bread  error" 

error  in  attempt 
p  i  c  ture 

to 

read 

input 

Pwrite  error" 

error  in  attempt 
put  picture 

to 

write 

out- 

Setupw  error" 

error  in  attempt 
put  picture 

to 

open 

out- 

Creating  file  s" 

file  s  is  being 
output 

created 

f  or 

AUTHOR 

Philip  A.  Dondes 

SEE  ALSO 

CXAP  <  VI I ) 


BUGS 

Pi f f oo  uses  SETUPB<VII>  and  BREAD(VII)  to  avoid  getting  any 
edge  reaction  on  the  border  of  the  picture. 

The  default  value(s)  for  omitted  input  window  dimensions  is 
the  actual  dimension  corresponding  to  the  input  picture. 


DIRN ( VI ) 


October  1979 


DIRN< VI ) 


NAME 

d  irn  -  edge  gradient  direction. 

SYNOPSIS 

d irn  f i 1 e2 

DESCRIPTION 

Pirn  reads  one  picture  from  standard  input<  and  a  second 
picture  from  the  file  given  as  argument.  It  computes 

atan2<  y»  x  ) 

scaled  to  be  in  the  range  -128  to  +127  (instead  of  -pi  to 
+p i ) -  at  each  point  of  the  output  picture-  where  x  and  y  are 
the  values  at  the  corresponding  points  in  the  two  input  pic¬ 
tures.  If  x  and  y  are  signed  edge  detector  outputs  in  x  and 
y  directions  respectively-  then  this  gives  the  edge  gradient 
direction  measured  in  256ths  of  a  revolution.  Note  that 
this  will  use  all  8  bits  of  a  byte.  The  result  picture  is 
written  to  standard  output.  All  files  have  GAP  style 
headers. 


FILES 

dirn. c  -  C  source  code 

binop.t  -  driver  program  for  binary  operators  in  general 
defns.  t  -  useful  definitions 

DIAGNOSTICS 

See  binop(VII),  from  which  driver  they  all  originate. 

AUTHOR 

Les  Kitchen 

SEE  ALSO 

binop(VII)-  sobel(VI).  euc(VI) 


BUGS 

See  b inop (VII). 
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DOODLE (VI) 


24-Octob er-1 979 


DOODLE (VI ) 


NAME 

doodle  -  2-d  and  3-d  graphics  on  the  Grinnell 

SYNOPSIS 

doodle 


DESCRIPTION 

Doodle  is  a  self-contained  system  for  creating  and  manipu¬ 
lating  2-  and  3-  dimensional  objects  and  functions  on  the 
Grinnell.  Objects  are  created  and  manipulated  by  a  set  of 
commands  which  allows  the  user  to  specify  what  part  of  the 
screen  is  to  be  used)  the  position  of  the  observer/  the 
direction  of  view/  etc.  The  following  commands  are  current¬ 
ly  available. 

Pi  so lau  control  c  ommand  s 

status  -  prints  the  observer's  current  position)  direction 
of  view>  the  size  and  shape  of  the  display  window/ 
and  the  size/  shape  and  position  of  the  viewport. 

viewport  llx  lly  urx  ury  -  establishes  the  size  and  position 
of  the  viewport  on  the  Grinnell  screen.  The  maximum 
size  is  4.0  by  3.75  which  is  the  entire  Grinnell 
screen.  (llx/lly)  is  the  lower  left  corner  and 
(urx/ury)  is  the  upper  right  corner/  which  are  ini¬ 
tially  set  to  <0/  0)  and  (4.0/  3.75). 

position  x  y  z  -  moves  the  observer  to  the  location  <x,y,z). 
This  is  initially  set  to  <6.0/  8.0,  7.5). 

d irection  i  j  k  -  sets  the  vector  components  of  the  direc¬ 
tion  of  view.  If  the  observer  is  at  point  (X)y,z) 
and  direction  is  set  to  (-x,-y>-z)  then  the  observer 
is  looking  at  the  origin.  The  initial  values  are 
(-6.  0,  -8.  0,  -7.  5). 

size  x  y  -  sets  the  size  of  the  display  window.  The  3-d 
space  is  projected  onto  this  window,  which  is  then 
projected  onto  the  viewport.  The  initial  window 
size  is  5.0  by  5.0. 

d istance  z  -  sets  the  distance  between  the  window  and  the 
observer.  The  observer  looks  through  the  center  of 
the  window.  Distance  is  initially  10. 

erase  -  erases  the  entire  screen,  regardless  of  the  viewport 
being  used. 

er asevo  -  erases  the  current  viewport,  but  not  its  frame,  if 
it  has  one. 


DOODLE ( V I ) 


24— Oc  tober-1979 


DOODLE (VI ) 


frame  -  draws  a  frame  around  the  current  viewport. 

unframe  -  erases  the  frame  around  the  current  viewport.  if 
there  is  one. 

Two-d  commands 

mov  x  y  -  moves  to  the  point  (x.y)  in  viewport  coordinates. 

drw  x  y  -  draws  a  line  from  where  you  are  to  the  point  (x.y) 
in  viewport  coordinates. 

move  x  y  -  moves  to  the  point  (x.y)  in  window  coordinates. 

draw  x  y  -  draws  a  line  from  where  you  are  to  the  point 

(x.y)  in  window  coordinates. 

Thr ee-d  commands 

3d  namel  name2  -  performs  the  required  transformations  on 
the  input  file  (namel)  and  outputs  the  transformed 
coordinates  to  the  output  file  (name2).  If  the  out¬ 
put  file  does  not  already  exist,  then  it  is  created. 

skel  name  -  takes  the  output  file  created  by  3d.  and  outputs 

a  wire  frame,  or  skeleton  plot  of  the  file. 

solid  name  -  takes  the  output  file  created  by  3d.  and  outputs 
a  solid  plot  of  the  file,  with  all  hidden  lines  re¬ 
moved. 


p 1 ot3  -  plots  three  dimensional  mathematical  functions,  and 
is  not  worth  discussing  in  its  present  state. 


Miscellaneous  command* 


promo t  string  -  changes  the  prompt  string. 


read  name  -  reads  input  commands  from  a  file  rather  than 
from  the  terminal.  When  the  entire  file  has  been 
read,  control  returns  to  the  terminal. 


end  -  terminates  the  program.  The  screen  is  left  as  is. 

3d  input  file  format 

Three  dimensional  objects  are  constructed  out  of  planar  po¬ 
lygons.  A  cube  for  instance  would  be  six  polygons,  each  of 
which  is  a  square.  A  polygon  is  specified  by  listing  its 
vertices.  An  edge  connects  each  vertex  in  the  list  to  the 
next  vertex,  with  the  last  vertex  connected  to  the  first, 
forming  a  closed  polygon.  The  polygons  may  have  any  number 
of  edges  greater  than  or  equal  to  three.  The  separate  po¬ 
lygons  do  not  have  to  be  related  in  any  way,  and  they  may 
even  penetrate  each  other. 
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DOODLE (VI ) 
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DOODLE (VI > 


The  input  file  format  is  as  follows. 

<file>  “>  <polygon>  *  <polygon>  ...  *  <polygon>  ** 

<polygon>  =>  <point>  ...  <point> 

<point>  =>  x  y  z  (three  numbers,  separated  by  at  least  1 
space) 

The  following  is  an  example  of  the  file  format.  The  list 
below  gives  the  points  for  two  squares  with  endpoints 
(O.O.O),  (1,0,0),  (1,1,0),  and  (0,1,0),  and  (0,0,1), 

(1,0,  1),  (1,  1,  1),  and  (0,  1,  1). 


0  0  0 
1  0  0 
1  1  0 
0  1  0 
* 

0  0  1 
1  0  1 
1  1  1 
Oil 
#* 

The  numbers  in  the  file  can  be  positive  or  negative  and  they 
may  include  a  decimal  point. 

AUTHORS 

Gyorgy  Fekete,  with  extensions  by  James  W.  Williams. 


FILES 

/dev/gr 


SEE  ALSO 

Pr inc ip les  of  Interactive  Computer  Graph ics.  1st  ed.  by 
Newman  and  Sproull. 

DIAGNOSTICS 

Doodle  tells  you  if  a  command  doesn't  make  sense,  or  js  not 
implemented  yet.  Error  messages  are  also  printed  if  dood le 
can  not  open  or  close  the  files  it  is  using,  or  if  one  of 
the  Grinnell  functions  can  not  be  peformed. 


BUGS 

Dood 1 e  may  occasionally  crash  for  unknown  reasons.  The  3-d 
function  plotting  feature  is  not  easy  to  use.  3-d  objects 
displayed  using  the  solid  command  may  not  penetrate  the 
plane  that  passes  through  the  observer's  position  and  is 
perpendicular  to  the  direction  of  view.  The  sk  el  command 
handles  this  situation  correctly. 
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ERASE 


ERASE 


NAME 

erase  -  Erase  the  display 


DESCRIPTION 

Erase  is  used  to  erase  the  entire  screen.  Either  the  image  chan¬ 
nels!  the  overlay  or  both  image  and  overlay  can  be  erased. 


USAGE 

erase 
erase  a 
erase  a  a 


EXAMPLE 
%  grid 

{Put  up  an  alignment  grid  in  the  overlay} 
&  erase  a 

{Erase  the  grid> 


AUTHOR 
Russ  Smith 


{erase  the  entire  screen  (overlay  and  image)} 
(erase  the  overlay} 

(erase  the  image} 


ER  SW 


ERSW 


NAME 

ersw  -  erase  window  contents  . 

DESCRIPTION 

When  more  than  one  user  is  manipulating  data  on  the  GRINNELL 
display  it  is  bad  form  to  use  the  erase  command.  Instead,  ersui  is 
used  to  erase  just  that  portion  of  the  screen  desired.  Ersui  can 
also  be  used  to  erase  selected  bit  groupings  of  the  window  <i.  e.  . 
one  can  erase  just  the  red  bits,  leaving  the  green  and  blue  un¬ 
touched  ) . 


USAGE 

ersui  Ckeyl 

upper  six  or  eight  bits  erased 
lower  six  or  eight  bits  erased 
red.  green  or  blue  bits  erased 
all  12  bits  erased  (default  keg) 
overlay  within  window  erased 


EXAMPLE 

X  posw  100  100  64  64 
7.  ersw 


key  —  u6. uS  — 
16.  18  — 
r.  g.  b  — • 


The  user  wants  to  erase  just  a  64  by  64  window  on  the  GRINNELL 
display,  leaving  the  rest  of  the  display  intact. 


EUC ( V I ) 


October  1979 


EUC (VI ) 


NAME 

euc  -  euclidean  combination  of  two  pictures  (L2  norm). 

SYNOPSIS 

euc  f i 1 e2 

DESCRIPTION 

Euc  reads  one  picture  from  standard  input/  and  a  second  pic¬ 
ture  from  the  file  given  as  argument.  It  computes 


/  2  2 
/  x  +  y 

\/ 

at  each  point  of  the  output  picture#  where  x  and  y  are  the 
values  at  the  corresponding  points  in  the  two  input  pic¬ 
tures.  If  the  result  of  this  expression  is  greater  than  63# 
it  is  set  to  63.  The  output  picture  is  written  to  standard 
output.  All  files  have  GAP  style  headers. 

Useful  for  combining  the  output  of  edge  operators  in  x  and  y 
directions. 


FILES 

euc. c  -  C  source  code 

binop.t  -  driver  program  for  binary  operators  in  general 
defns.  t  -  useful  definitions 

DIAGNOSTICS 

See  binop(VII).  from  which  driver  they  all  originate. 

AUTHOR 

Les  Kitchen 

SEE  ALSO 

binop(VII)#  sobel(VI).  dirn(VI) 


BUGS 

See  b inop (VII). 

Chopping  at  63  may  be  a  nuisance. 
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EXP AND (VI) 


June  1979 


EXPAND (VI) 


NAME 

expand  -  expand  a  given  picture  and  display  it  on  the  Grin- 
nell 


SYNOPSIS 

expand  pfile  size  factor 


DESCRIPTION 


pf  ile 
size 

factor 


«»pand  di 
relative 


an  n  x  n  picture  wi 
an  integer  specifyi 
expanded 

an  integer  specifyi 
the  picture 

splays  the  picture 


th 
ng 

ng 

on  the  Grinnell. 


to  be 
expand 

The  window  is 


GAP  header 

the  size  of  the  picture 
the  number  of  times  to 


to  (0,0)  . 


FILES 

/dev/gr 

DIAGNOSTICS 

all  deal  with  file  access  errors  and  are  sel f-exp lanatory 
AUTHOR 

Sanjay  Ranade 

SEE  ALSO 

shrink (VI ) 


BUGS 


The  picture  size  can  be  obtained  from  the  header.  Extra 
parameters  can  be  added  to  specify  a  general  window  on  the 
Grinnell. 


FREEZE 


FREEZE 


NAME 

freeze  -  Freeze  input  from  the  video  digitizer 


DESCRIPTION 

Freeze  is  used  to  freeze  the  current  input  from  the  video  digi¬ 
tizer.  It  is  usually  used  immediately  following  the  tv  command, 
though  it  can  be  used  by  itself.  Used  alone,  freeze  can  average 
up  to  64  frames  of  input  or  sum  up  to  255. 


USAGE 

freeze  Cttframes  shift! 

♦frames  =  1  ->  255 
shift  *  0  ->  7 


EXAMPLE 
%  tv 

{Start  input} 

%  freeze 

{freeze  current  image} 

OR 

%  erase 

{clear  screen} 

&  freeze  64  6 

{average  *2  seconds  of  video  input} 


AUTHOR 
Russ  Smith 


GETW 


GETW 


NAME 

getw  -  redisplay  currently  defined  window 
DESCRIPTION 

Getw  is  used  to  redisplay  a  window  previously  defined  but  subse¬ 
quently  erased.  Often  after  using  nosui  to  define  a  window  a  user 
will  erase  the  overlay.  hence  making  the  window's  location  diffi¬ 
cult  (if  not  impossible)  to  discern.  Getw  will  output  the  first 
columnj  first  row.  number  of  columns.  and  number  of  rows  informa¬ 
tion  to  the  user's  terminal  and  redraw  the  window  on  the  display. 
If  an  argument  is  given  the  cursors  will  be  turned  on  but  the 
overlay  will  not  be  erased. 

USAGE 

getw  Col 

EXAMPLE 

%  posw  100  100  64  64 
X  hstw  u6 
%  getw  o 

This  user,  after  computing  a  histogram  of  a  window  and  writing  it 
into  the  overlay  (thus  erasing  the  window  outline),  wishes  to 
know  the  true  position  of  the  window  but  does  not  want  to  erase 
the  histogram. 


GMAP  (Author:  Donald  J.  Gerson) 


This  program  does  false  color  mapping  (alias  color 
slicing)  of  a  black  and  white  image  stored  in  the  Grinnell 
by  modifying  the  lookup  table.  The  standard  way  to  get  an 
image  into  the  Grinnell  —  using  the  TV  camera  —  is  to 
enter  these  commands: 

araii 

tv 

freeze 


To  run  aman  do: 

color 

omao 


A  typical  execution  of  amao  goes  something  like  this 
(user  input  is  underlined): 

do  you  want  to  store  picture  (y  or  n)? 

a 

number  of  bits  per  pixel? 

S 

give  x-base 

a 

give  y-base 

a 

give  size 
ISO 


What  you  enter  controls  the  placement  of  the  color  tri¬ 
angle.  It  makes  no  difference  whether  you  save  the  picture 
or  not;  the  program  doesn't  ever  restore  it.  The  bits  per 
pixel  valu«  may  be  any  positive  number.  (Enter  zero  at  your 
own  risk!)  The  x-base  and  y-base  are  the  location  where  you 
want  the  color  triangle  placed>  and  ''size''  is  the  size  to 
make  the  triangle. 

After  qmao  has  drawn  the  triangle*  use  cursor  #1  to 
mark  pixels  in  the  color  triangle.  You  can  either  leave  the 
track  switch  on  to  make  a  continuous  line*  or  with  the  track 
switch  off*  use  the  * N  enter '  '  button  to  mark  single  pixels. 
The  colors  you  mark  -  and  the  order  you  mark  them  in  - 
determine  the  mapping  from  grey  levels  to  colors.  For  exam¬ 
ple:  if  you  mark  a  red*  a  white*  and  a  blue  pixel*  (in  that 
order)  the  greyscale  will  be  divided  into  three  equal  seg¬ 
ments.  The  darkest  segment  will  be  mapped  into  red*  the  mid¬ 
dle  one  into  white*  and  the  brightest  into  blue. 


To  indicate  that  you  are  done,  press  the  *  v  enter '  '  but¬ 
ton  an  extra  time  while  the  cursor  remains  on  the  last  pixel 
you  marked.  Qmao  will  then  load  the  mapping  you  have  de¬ 
fined  into  the  Grinnell's  lookup  table  so  you  can  see  the 
result  of  the  mapping.  Zt  then  asks  if  you  are  done.  to 
which  you  may  answer  "no"  if  you  want  to  try  a  different 
mapping.  In  this  case  omao  starts  over  so  you  must  enter 
the  color  triangle  parameters  again.  When  you  quit,  the 
current  mapping  remains  in  the  lookup  table  so  it  can  be 
used  with  other  pictures.  Doing: 

tv 

will  run  the  image  from  the  tv  camera  through  the  mapping  so 
you  can  watch  it  in  real  time. 

To  restore  the  lookup  table  to  the  identity  mapping  do: 
qtbld  s 


GRID 


GRID 


NAME 

grid  -  Alignment  grid,  program 
DESCRIPTION 

Grid  is  a  small  routina  used  to  produce  a  grid  of  lines  spaced  32 
pixels  apart  in  the  overlay  of  the  GRINNELL  display.  Though  it 
was  designed  to  aid  in  the  correction  of  the  aspect  ratio  of  a 
television  monitor  being  aligned>  it  can  possibly  be  put  to  other 
use. 

USAGE 

grid 

EXAMPLE 
£  grid 

<Put  up  the  grid> 

'L 

AUTHOR 
Russ  Smith 


NAME 

gt  -  GRINNELL  memory  plane  test 
pgt  -  printing  version 

DESCRIPTION 

Gt  is  used  to  visually  check  out  individual  image  bit  planes. 
Using  the  lookup  table  and  solid  rectangle  generation  it  will 
reveal  bit  dropouts  as  white  spots  on  an  otherwise  dark  screen. 
Pat  will*  in  addition  plot  out  the  results  on  the  PRINTRONIX 
line  printer  (for  hardcopy  confirmation). 

USAGE 

gt  Cb  it  #1 
pgt  Cb i t  #1 

EXAMPLE 

A  pgt  7 

{test  bit  #7  and  plot  the  results) 

% 

AUTHOR 
Russ  Smith 


GTBLD 


GTBLD 


NAME 

gtbld  -  GRINNELL  lookup  table  load 
DESCRIPTION 

Qtb 1 d  can  be  used  to  load  the  GRINNELL  hardware  lookup  table  with 
preset  values.  Currently  the  table  may  be  loaded  with  the  values 
0->4095  (standard)<  4095->0  ( c omp 1 ement > »  or  0+4095  (threshold). 
Quite  often  this  program  is  used  to  remap  images  created  from  the 
T. V.  camera  for  manipulation  by  programs  running  on  the  UNIVAC 
1108  (The  GRINNELL  says  black  is  zero,  the  1108  (XAP),  white). 

OSAGE 

gtbld  CsKrlCt  tvall 
s  —  O  ->  4095 
r  —  4095  ->  0 

t  tval  — *  threshold  at  12-bit  integer  value  tval 

EXAMPLE 

X  gtbld  t  3000 

Call  pixels  valued  3000  up  will  display  as  white, 
all  pixels  valued  2999  down  as  black} 


AUTHOR 
Russ  Smith 


©TEST 


©TEST 


NAME 

gtest  -  GRINNELL  Internal  Test  program 

DESCRIPTION 

Gtest  consecutively  performs  the  four  internal  hardware  tests  of 
the  GRINNELL  DISPLAY  SYSTEM  as  the  keyboard  <RETURN>  key  is 
pressed.  It  is  usually  used  on  pouerup  of  the  system  to  load 
the  lookup  table>  reset  the  device  registers  and  initialize  the 
device  memory. 


USAGE 

gtest 


EXAMPLE 


X  gtest  <RETURN> 


Hit  <RETURN>  For  Each  Test 


<RETURN> 

< —  Internal 

test 

#1 

<RETURN> 

< —  Internal 

test 

#2 

<RETURN> 

<-—  Internal 

test 

#3 

<RETURN> 

< —  Internal 

test 

#4 

displayed 

displayed 

displayed 

displayed 


AUTHOR 
Russ  Smith 


HSTW 


HSTW 


NAME 

h stu  -  compute  and  display  histogram  of  window 

DESCRIPTION 

Hstw  will  compute  a  histogram  of  the  window  contents  and  display 
a  bar  graph  in  the  overlay.  The  previous  contents  of  the  overlay 
will  be  erased.  The  histogram  can  be  of  the  color  bits  (red< 
green.  blue)  or  of  the  upper  or  lower  six  or  eight  gray  level 
bits. 


USAGE 


upper  six  or  eight  bits  histogrammed 
lower  six  or  eight  bits  histogrammed 
red.  green  or  blue  bits  histogrammed 


EXAMPLE 
X  freeze 

X  posw  0  0  480  504 
£  hstw  u6 


hstw  key 

key 


u6j  u8 
16.  18 
r.  g.  b 


The  user  has  taken  one  tv  frame  from  the  video  digitizer  input 
and  wishes  to  see  a  histogram  of  the  entire  image  thus  obtained. 
The  digitizer  produces  six  bit  output  hence  the  'u6'  argument. 


4 


HT  HT 


NAME 

ht  -  Print  a  semi-halftone  of  the  display 


DESCRIPTION 

Ht  will  take  the  image  as  displayed  (i.  e. >  through  the  lookup 
table)  and  plot  a  semi-halftone  of  it  for  the  PRINTRQNIX  line 
printer.  The  image  is  printed  as  a  collection  of  black  and  white 
spots  by  an  error  correcting  process.  As  such,  some  loss  of  small 
details  should  be  expected.  The  output  can  be  piped. 


USAGE 

ht  >  /dev/lp 
ht  !  opr 


EXAMPLE 
%  scale 

{Interactive  gray  scale  remapping}- 
X  ht  i  opr 

{Output  piped  to  the  printer  spooler}- 
'L 


AUTHOR 
Russ  Smith 


LSCAN 


LSCAN 


NAME 

lscan  -  Display  a  cross  section  of  an  image 
DESCRIPTION 

Lscan  will  display  a  vertical  or  horizontal  cross  section  through 
an  image.  A  graylevel  image  can  be  thought  of  as  possessing 
three  dimensions:  height*  widths  and  brightness.  This  program  is 
used  to  display  the  brightness  dimension  as  a  cross  section 
through  one  of  the  other  two  dimensions.  When  this  program  is 
run  a  white  line  will  appear  on  the  screen.  This  line  is  moved 
using  the  TRACK  ball  and  cursor  #1  to  that  portion  of  the  image 
through  which  the  cross  section  is  wanted.  When  the  ENTER  button 
on  the  track  ball  unit  is  pushed  twice*  the  cross  section  will 
appear  on  the  screen  (in  the  overlay).  This  sequence  can  be  re¬ 
peated  as  often  as  wished.  To  exit  hit  <RUBQUT>. 

USAGE 

lscan  Clength  Call 

length  —  width  (or  height)  of  cross  section 
a  —  a  vertical  line  will  be  used 


EXAMPLE 

&  lscan  512 

<A  horizontal  full  screen  cross  section)- 
<RUBOUT> 

*/. 


AUTHOR 
Russ  Smith 


MAPW 


MAPW 


NAME 

mapu  —  map  displayed  window  into  stored  window 

DESCRIPTION 

Maow  is  used  to  map  the  stored  values  of  the  window  through  the 
lookup  table  and  back  into  the  stored  values.  That  is>  it 
transforms  the  stored  values  as  they  are  displayed  so  that  they 
actually  take  on  the  displayed  values.  It  is  usually  used  after 
the  lookup  table  has  been  changed  so  that  the  lookup  table  can 
immediately  be  reloaded  with  the  standard  sequence  of  values. 
Hence  other  concurrent  users  of  the  GRINNELL  display  will  not 
have  their  own  images  displayed  incorrectly  for  an  extended 
period  of  time. 

USAGE 

mapw 

EXAMPLE 

X  gtbld  t  3000 
X  posw  100  100  64  64 
X  mapw 
X  gtbld  s 

This  user  has  thresholded  an  image»  mapped  it>  and  reloaded  the 
lookup  table  so  as  to  not  interfere  with  other  potential  users. 


i 


MAX  <  VI )  October  1979  MAX(VI) 


NAME 

max  -  pointwise  maxmum  of  two  pictures. 

SYNOPSIS 

ma x  f i 1 e2 

DESCRIPTION 

Max  reads  one  picture  from  standard  input,  and  a  second  pic¬ 
ture  from  the  file  given  as  argument.  It  computes 

max (  x,  y  ) 


at  each  point  of  the  output  picture,  where  x  and  y  are  the 
values  at  the  corresponding  points  in  the  two  input  pic¬ 
tures.  The  output  picture  is  written  to  standard  output. 
All  files  have  GAP  style  headers. 

FILES 

max.c  -  C  source  cade 

binop.  t  -  driver  program  for  binary  operators  in  general 
defns.  t  -  useful  definitions 

DIAGNOSTICS 

See  binop(VII),  from  which  driver  they  all  originate. 

AUTHOR 

Les  Kitchen 

SEE  ALSO 

b inop  <  VI I > 

BUGS 

See  binop (VII). 


MS  (Author:  Lee  Moore) 


This  program  is  invoked  by: 

ms  <start>  C  <increment>  C  <c o 1 or>  3  ] 

it  generates  a  series  of  "munching  squares"  patterns  on  the 
Grinnell.  The  pattern  uses  the  entire  screen  and  its  ap¬ 
pearance  is  determined  by  the  parameters  on  the  call  line. 
The  increment  and  color  values  can  be  defaulted  to  one  (1) 
and  4095*  respectively.  The  color  argument  is  an  integer 
between  zero  (0)  and  4095  which  is  the  value  to  be  placed  on 
the  screen. 


The  algorithm  can  be  best  explained  by  the  following  program 
fragment: 

n  :  ■  start; 
i  : *  increment; 

FOR  i  :*  0  TO  lastx  DO  BEGIN 

FOR  x  :  sb  o  to  lastx  DO  BEGIN 
y  : *  x  XOR  n; 
putpoint ( x. y )  END 
n  : »  n  r  i  END 


where  the  routine  "putpoint"  puts  a  point  at  <x»y)  on  the 
display.  Different  values  for  start  and  increment  produce 
different  patterns.  Larger  increments  tend  to  produce  finer 
grain  patterns*  especially  if  the  values  are  prime. 

Once  the  above  fragment  completes  its  execution*  the 
program  will  place  black  points  instead  of  colored  ones  and 
then  repeats.  When  this  is  complete*  the  whole  process  is 
started  over  again. 


MUL (VI) 


August  1979 


MUL (VI) 


NAME 

mul  -  scale  a  picture  by  a  constant 

SYNOPSIS 

mul  [constant! 

DESCRIPTION 

Mul  reads  a  picture's  header  from  the  standard  input  file 
and  echoes  it  to  the  standard  output  file.  Cs i ze  then  reads 
an  integer  picture  of  dimension  NRQW  rows  by  NCOL  columns* 
where  NROU  is  the  number  of  rows  in  the  input  picture  and 
NCOL  is  the  number  of  columns  in  the  input  picture*  from 
the  standard  input*  multiplies  every  pixel  by  constant  and 
writes  it  to  the  standard  output  file.  constant  is  1  if  un¬ 
specified. 

FILES 

DIAGNOSTICS 

"Header  not  read" 

"Picture  width  too  large" 


"Illegal  size" 

"Too  much  data*  row  count  expired" 
"Unexpected  EOF  encountered" 
"Input  pipe  not  empty" 


AUTHOR 

Philip  A.  Dondes 

SEE  ALSO 

pack(VI) 
unpac  k (VI ) 

BUGS 


first  12  bytes  of  picture 
not  read 

#  of  columns  in  input 
picture  exceeds  input 
buffer  length 
newsize  <  1  or 


#  of  rows  in  picture  ex¬ 
ceeded 

eof  encountered  before 
picture  completed 
data  still  resides  in  in¬ 
put  pipe 


1 


MUNCH 


MUNCH 


NAME 

munch  -  Munching  squares  demonstration  program 


DESCRIPTION 

Munch  is  a  shell  program  uihich  starts  up  three  munching  squares 
routines  in  the  threa  primary  colors.  It  makes  for  an  impressive 
demonstration  of  the  speed  at  which  individual  points  can  be 
written.  It's  also  pretty.  The  programs  will  be  stopped  when  the 
RUBOUT  button  is  pushed. 


USAGE 

munch 


EXAMPLE 
3C  munch 

m 

at 

kt 

•Cr#»  g##  b#  —  The  process  numbers  for  each  color) 
<RUBOUT> 

-Cthe  user  kills  the  processes) 


AUTHOR 
Russ  Smith 


'  ' PAINT  SV  NUMBERS' '  (Author:  Fred  Blonder) 

The  ''paint  by  numbers'"  system  consists  of  four 
seperate  programs.  These  are:  dram  which  allows  you  to  in¬ 
put  line  drawings  into  the  Grinnell  system  using  the  track 
ball  and  your  terminal  keyboard>  b inin  which  reads  the  line 
drawing  from  the  Grinnell  into  a  Unix  file  as  a  binary  pic¬ 
ture.  connect  which  runs  the  (four  neighbor)  connected  com¬ 
ponent  labeling  algorithm  on  the  binary  picture  file.  pro¬ 
ducing  a  labeled  picture  file,  and  paint  which  allows  you  to 
use  the  track  ball  to  mix  colors  and  use  them  to  fill  in  any 
component  in  the  labeled  image,  displaying  the  result  on  the 
Grinnell.  A  description  of  each  of  these  programs  follows. 


DRAW 


Draw  takes  no  arguments,  and  uses  the  entire  screen  of 
the  Grinnell.  When  it  is  run.  cursor  #1  should  be  turned 
on.  cursor  #2  off.  and  the  track  switch  should  be  on.  You 
use  the  track  ball  to  move  cursor  #1  to  where  you  want  to 
start  a  line,  and  then  you  can  draw  the  line  either  freehand 
-  with  the  track  ball  -  or  have  the  Grinnell  draw  a  straight 
vector. 

To  do  it  freehand,  type  on  the  keyboard.  This 
puts  the  program  in  the  ''pen  down"'  condition,  where  pixels 
are  turned  on  wherever  you  move  cursor  #1.  Type  ' ' u '  '  to 
lift  the  '  'pen  '  '. 

To  draw  a  straight  vector  type  v'm''.  This  drops  cur¬ 
sor  #2  at  the  current  location  of  cursor  #1.  Move  cursor  #1 
to  the  other  end  of  the  desired  line  and  type  ''1/'.  This 
places  a  vector  between  the  cursors. 

To  aid  in  drawing  geometric  figures,  the  coordinates  of 
both  cursors  are  displayed  on  the  overlay  channel  in  the 
upper  left  hand  corner  of  the  screen.  along  with  the  pen 
(up/down)  position.  Since  a  single  pixel  can  connect  two 
regions,  you  must  take  care  to  enclose  all  the  regions  in 
the  picture. 


SiM 


This  program  copies  a  rectangular  window  from  the  Grin¬ 
nell  -  treating  it  as  a  binary  picture  -  into  an  arbitrary 
Unix  file.  The  window  is  selected  by  positioning  the 
Grinnell's  cursors  at  any  two  of  its  diagonally  opposite 
corners  before  running  the  program.  B in  in  is  called  as  fol¬ 
lows: 


binin  -ci  <filename> 


The  c.  option  causes  the  program  to  examine  the  cursors 
to  determine  the  window;  the  default  is  to  read  in  the  en¬ 
tire  screen.  The  i.  option  is  necessary  to  cause  the  program 
to  invert  the  picture  as  it  is  read  in  because  the  connect 
program  likes  it  that  way.  <Filename>  may  be  the  name  of 
any  writeable  Unix  file/  but  for  traditional  reasons  it 
should  begin  with  ''/tmp/''.  The  file  will  be  created  if  it 
does  not  exist. 


CONNECT 

This  program  doesn't  use  the  Grinnell.  It  runs  the  con¬ 
nected  component  labeling  algorithm  on  its  input  picture/ 
producing  a  component  labeled  output  picture.  It  is  called 
like  this: 

connect  <binary  input  picture>  <labeled  output  picture> 

where  <Ibinary  input  picture>  will  normally  be  the  file  you 
just  created  using  b in  in.  The  same  comment  applies  to  the 
name  you  give  Clabeled  output  picture>  as  to  the  file  name 
given  to  b inin.  Connect  prints  out  some  information  as  it 
runs  to  let  you  know  what  is  happening. 


PAINT 

This  is  the  fun  and  exciting  part.  To  work  properly 
cursor  #1  should  be  turned  on/  and  #2  off.  Paint  is  called 
like  this: 

paint  Clabeled  output  picture> 

It  displays  the  picture  as  a  line  drawing  in  the  lower  left 
hand  corner  of  the  Grinnell 's  screen/  and  displays  a  palette 
in  the  upper  right  hand  corner. 

To  mix  colors  the  cursor  must  be  positioned  within  the 
block  of  the  palette  containing  the  three  primary  color 
bars.  You  can  either  leave  the  track  switch  off/  move  the 
cursor  over  any  color  bar  to  the  desired  length  of  the  bar 
and  hit  the  enter  button/  or  you  may  leave  the  track  switch 
on/  and  position  the  cursor  over  any  color  bar  and  move  it 
up  or  down  while  the  color  bar  changes  length  along  with  it. 
The  currently  selected  color  is  continuously  displayed  in  a 
rectangle  at  the  top  of  the  palette. 

To  color  in  a  region  of  the  picture  with  the  currently 
selected  color/  move  the  cursor  (with  the  track  switch  off) 
to  any  point  within  the  region/  and  press  enter.  No  more 
commands  may  be  given  to  the  program  until  that  region  has 
been  colored  in.  The  same  color  may  be  used  to  color  any 


number  of  regions  without  needing  to  reselect  the  color.  A 
region  may  be  recolored  any  number  of  times*  the  previous 
color  in  the  region  will  be  overwritten  completely. 

When  you  are  done  painting*  exit  by  pressing  the  rubout 
key  on  your  terminal.  The  palette  will  be  erased*  and  the 
borders  between  the  components  will  be  erased  and  then 
filled  in*  by  blending  the  colors  of  the  adjacent  regions. 


PGP(I) 


2-October-1979 


PGP ( I ) 


NAME 

pgp  -  print  text  on  the  Printronix  using  fonts 
SYNOPSIS 

pgp  <fontname>  <output-f ile> 

DESCRIPTION 

Pgp  reads  text  from  its  standard  inputi  and  the  font 
file  associated  with  f ontname.  It  produces  an  output  file 
containing  the  text,  set  in  the  specified  font,  along  with 
the  neccessary  control  codes  to  put  the  Printronix  into  plot 
mode.  This  file  may  be  sent  directly  to  the  printer,  or 
edited  and  concatenated  with  other  similar  files  first. 

If  a  file  called:  f ontname  doesn't  exist  dqp  appends 
' ' .  fnt '  '  to  the  name  and  tries  to  find  it  again. 

Many  of  the  fonts  have  printing  characters  defined  for 
several  of  the  ASCII  control  codes  which  may  be  bothersome 
to  type  from  a  terminal.  These  codes  can  be  entered  by  typ¬ 
ing  "'/.a''  for  control-A,  '  '  7.b  '  '  for  control-B,  &c.  A 
'  '  ’/.*/. ‘  '  is  interpreted  as  a  single 


AUTHOR 

Original  version:  Lee  Moore 
Current  version:  Fred  Blonder 


FILES 

<fontname>.  fnt 
SEE  ALSO 

DESCFNT  < I ) ,  TITLE < I ) ,  BIGLET(I),  FONT(III),  FONT(V) 
DIAGNOSTICS 

.  .  .  are  given  for  an  unknown  font,  or  a  character  that  is 

not  defined  in  the  specified  font. 


BUGS 

If  the  output  line  length  is  greater  than  what  will  fit  on 
the  Printronix,  the  Printronix  will  not  go  into  plot  mode, 
and  the  file  prints  as  garbage.  This  is  a  bug  in  dqp  and 
not  a  problem  with  the  Printronix. 


PHIST  < VI ) 


1 0-No vember-1 977 


PHIST (VI ) 


NAME 

phist  -  Computer  Vision  Lab  Histogram  Printing  Routine 
SYNOPSIS 

oh ist  C  -  3  xappici  xappic2  ...  xappicn 
DESCRIPTION 

Phist  mill  print  the  histogram  for  each  PDP/XAP  formatted 
picture  file  given  as  an  argument.  If  the  dash  is  presenti 
only  a  summary  is  printed  on  the  standard  output.  If  the 
dash  is  not  present,  actual  bar  graphs  will  be  plotted  on 
the  PRINTRONIX  line  printer. 


FILES 

/dev/lp 

BUGS 


1  - 


POSW, OPOSW 


POSW, OPOSW 


NAME 

posw  -  Position  a  window  (use  overlay) 
oposw  -  Position  a  window  (nonoverlay) 


DESCRIPTION 

Posw  (oposw)  is  used  to  position  the  two  cursors  so  as  to  define 
a  rectangular  window  on  the  Grinnell  display.  Cursor  #1  defines 
the  lower  left  corner,  cursor  #2  defines  the  upper  right  corner. 
If  posw  is  used,  the  window  will  be  displayed  in  the  overlay  (and 
anything  else  in  the  overlay  will  be  erased),  if  oposw  is  used, 
the  two  cursors  will  be  turned  on  but  the  overlay  will  remain  un¬ 
touched.  This  routine  is  to  be  used  before  all  other  window 
oriented  programs. 


USAGE 

posw  CCfc  fr3  nc  nr3 
oposw  CCfc  fr3  nc  nr3 

fc. fr  -  first  column  and  row  of  window 
nc.nr  -  number  of  columns  and  rows 

If  no  arguments  are  given  the  window  will  be  completely  dynamic 
in  both  size  and  position.  If  the  number  of  columns  and  rows  is 
given,  only  the  position  of  the  window  will  be  dynamic.  If  all 
arguments  are  given.  the  window  will  be  immediately  positioned 
(static  position  and  size).  The  TRACK  ball  unit  is  used  to  posi¬ 
tion  the  window  and  change  its  size.  When  the  window  is  correctly 
positioned,  pushing  the  ENTER  button  on  the  TRACK  ball  unit  twice 
will  fix  the  window  in  place. 


EXAMPLE 
X  posw 

-Cuser  wants  to  interactively  change 
position  and  size> 

£  posw  64  64 

■Cuser  wants  to  interactively  position  a 
64  by  64  window> 

&  posw  100  100  64  64 

Cuser  knows  exactly  where  to  position  a 
64  by  64  window. 
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NAME 

put  -  Put  an  image  on  the  Grinnell  display 

3 

SYNOPSIS 

out  Cfc  fr3  <  file 
outs  Cfc  fr3<  file 

DESCRIPTION 

Put  is  used  to  place  an  image  on  the  Grinnell  display.  The 
image  should  have  a  correct  header  (GAP).  Both  out  and  puts 
can  put  12-bit  images  (full  color).  Put  is  used  for  images 
having  six  bit  gray  level  ranges.  Put8  is  used  for  images 
having  eight  bit  gray  level  ranges.  With  either  version  of 
out  the  column  and  row  for  the  lower  lefthand  corner  of  the 
image  may  be  specified.  If  the  column  and  row  are  not  given 
a  cursor  will  be  displayed.  This  marks  the  lower  lefthand 
corner  of  the  image.  It  may  be  positioned  using  the  TRACK 
ball  unit.  When  the  cursor  is  correctly  positioned,  push  the 
<RV80UT>  key  to  actually  put  the  image. 


FILES 

/dev/gr 

SEE  ALSO 

header  (V) 
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NAME 

savw  -  read  window  contents  off  display 


DESCRIPTION 

Savw  reads  the  contents  of  the  display  and  writes  data  to  the 
standard  output.  Either  image  data  or  the  overlay  may  be  read 
off  in  any  raster  scan  direction  (left  to  right*  right  to  left, 
bottom  to  top,  etc.  ).  Arguments  to  the  program  select  that  por¬ 
tion  of  the  data  to  be  saved  as  well  as  the  direction  of  the 
scan.  A  12— byte  header  containing  number  of  columns,  number  of 
rows,  and  bytes  per  pixel  information  will  precede  the  data  un¬ 
less  the  is  used  with  the  mode  argument. 


USAGE 

savw  key  Ct-lmodel  >  file 
savw  key  CC-lmode]  >  device 
savw  key  CC-lmode]  !  process 


key  —  u6,  u8  —  upper  six  or  eight  bits  saved 
16,  IS  —  lower  six  or  eight  bits  saved 
r,  g,  b  —  red,  green  or  blue  bits  saved 

a - all  12  bits  saved 

o - overlay  saved 


If  the  is  present,  no  header  is  output 

mode  —  lb,  It,  rb,  rt,  bl,  br,  tl,  tr 
1  —  left  to  right 
r  —  right  to  left 
b  —  bottom  to  top 
t  —  top  to  bottom 

i.  e.  ,  'It'  would  be  a  standard  tv  scan 
'lb'  is  the  default  scan 


EXAMPLE 

X  posw  0  0  510  510 
X  savw  u8  -It  >  /dev/rdrO 

This  user  is  sending  a  gray  level  image  from  the  GRINNELL  display 
to  the  scanout  device  (in  order  to  make  a  poloroid  photo).  Note 
that  no  header  is  sent  and  that  a  standard  tv  scan  (left  to 
—ight.  top  to  bottom)  is  used. 


SCALE 


SCALE 


NAME 

scale  -  Interactive  grayscale  mapping 
DESCRIPTION 

Scale  is  used  to  interactively  change  the  hardware  lookup  table 
graylevel  mapping.  The  x-axis  of  the  monitor  screen  is  considered 
to  represent  the  possible  range  of  displayed  (through  the  lookup 
table)  pixel  values.  The  y-axis  is  considered  to  represent  the 
actual  stored  value  range.  Hence  if  one  were  to  plot  the  mapping 
function  of  the  standard  lookup  table  values  a  45  degree  line 
starting  at  the  origin  and  proceeding  to  point  (511.511)  would 
result.  Using  the  TRACK  ball  and  cursor  #1  this  function  can  be 
interactively  changed  (i.e..  the  line  can  be  redrawn)  allowing 
any  graylevel  mapping  such  as  multiple  thresholds,  contrast 
stretching,  etc. 

USAGE 

scale 

EXAMPLE 
%  scale 

tlnteractive  function  mapping)- 
<RUBOUT> 

*/. 


AUTHOR 
Russ  Smith 
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NAME 

shrink  -  progressively 
id  ' 

SYNOPSIS 

shrink  pfile  ftemp 


shrink  a  picture  to  produce  a 


'pyram- 


DESCRIPTION 

pfile  a  64  x  64  picture  with  the  standard  12-byte  header 
ftemp  a  filename  template.  If  this  is  'ftemp  '»  the  files 
created  would  be  'ftempl'.  'ftemp2' . 'ftemp6'. 

shrink  produces  6  files  corresponding  to  each  level  of  the 
pyramid,  'ftempl'  is  32  x  32  »  'ftemp2'  is  16  x  16  ....  etc. 
A  pixel  in  a  level  n  file  is  the  average  of  four  correspond¬ 
ing  pixels  in  the  level  <n-l>  file. 


FILES 

f temp 1» f temp2 . ftemp6  picture  files  created 

DIAGNOSTICS 

a  few.  all  are  clear  and  self-exp lanatory . 

AUTHOR 

Sanjay  Ranade 

SEE  ALSO 

expand (VI ) 


BUGS 

At  the  moment  the  program  only  shrinks  64  x  64  GAP  pictures. 
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NAME 

sobel  -  applies  Sobel  edge  operator  to  a  picture. 

SYNOPSIS 

sobel  d 


DESCRIPTION 

Sobe 1  reads  a  picture  file  from  standard  input,  applies  the 
Sobel  operator,  and  writes  the  result  to  standard  output. 
Both  pictures  have  GAP  style  headers,  and  the  output  picture 
is  the  same  size  as  the  input  picture.  If  the  first  charac¬ 
ter  of  the  direction  parameter  d  is  an  then  the  opera¬ 

tor  is  applied  in  the  x  direction,  if  a  ' y ' ,  then  it  is  ap¬ 
plied  in  the  y  direction.  For  a  3  by  3  neighborhood: 

ABC 

DEF 

GHI 

the  x  direction  operator  produces 

(C  +  2*F  +  I  -  A  -  2*D  -  G)  /  4; 

the  y  direction  operator  produces 

(A  +  2*3  +  C  -  G  -  2*H  -  I)  /  4. 

(Note  that  x  increases  left  to  right  across  the  picture,  y 
increases  bottom  to  top.  The  picture  is  read  row  by  row, 
bottom  to  top.  )  The  outer  border  of  the  output  picture  will 
be  all  zeroes,  since  the  Sobel  operator  cannot  be  applied 
right  up  against  the  edge. 


FILES 

sobel. c  -  C  source  code  for  Sobel  operator 

local,  t  -  driver  program  for  local  operators  in  general 

defns.  t  -  useful  definitions 

DIAGNOSTICS 

"Input  picture  not  a  byte  per  pixel  file!" 

-  header  byte  count  not  one 
"Input  picture  too  small  for  operator!" 

-  smaller  than  3x3 
"Premature  end  of  input!" 

-  picture  smaller  than  expected  from  size  given  in 
header 

"Excess  input  data  remaining!" 

-  picture  bigger  than  expected  from  size  in  header 
"Direction  argument  missing!" 

"Direction  must  be  x  or  y!" 


AUTHOR 

Les  Kitchen 


J 
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SOBEL  <  VI > 


SEE  ALSO 

local (VII),  e  u  c  <  V I  ) ,  d i r  n ( V I ) 


BUGS 

Works  only  for  1  byte  per  pixel  files. 

Read  error  uu  1 1  also  cause  "Premature  end  of  input!"  mes¬ 
sage. 
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STRETCH 


NAME 

stretch  -  Graylevel  range  stretching 

DESCRIPTION 

Stretch  changes  the  lookup  table  values  in  order  to  produce  a  64 
graglevel  displayed  image  from  a  less  than  64  level  stored  image. 
The  user  inputs  to  the  program  the  lowest  and  highest  stored 
values  of  the  image.  These  will  then  become  pure  black  and  pure 
white  in  the  stretched  image.  Note  that  only  the  displayed  image 
will  be  affected.  The  stored  image  remains  the  same  (see  MAPW). 

USAGE 

stretch  low  high 

low  —  low  value  of  stored  image 
high  —  high  value  of  stored  image 


EXAMPLE 

X  stretch  7  43 

<7  »>  0*  43  ==>>  63.  values  in  between  suitably  changed} 

2. 


AUTHOR 
Russ  Smith 
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NAME 

tempera  -  allows  on®  to  "paint"  on  Grinnell  using  trackball 
as  "brush" 

SYNOPSIS 

tempera 

DESCRIPTION 

TEMPERA  is  a  program  that  simulates  tempera  painting.  The 
screen  of  the  Grinnell  monitor  is  the  "canvas;"  the 
"paintbrush"  is  the  trackball  device.  The  artist  may  direct 
a  "palette"  to  appear  on  the  screen>  when  it  is  desired  to 
electronically  mix  another  color  of  "paint."  At  the  begin¬ 
ning  of  the  program*  the  artist  may  choose  either  subtrac¬ 
tive  color  mixing  (primary  colors:  cyan*  magenta*  yellow)  or. 
additive  color  mixing  (primary  colors:  red*  green*  blue)  or 
a  "premixed"  palette  (a  faster  way  of  choosing  colors)*  to 
be  used  throughout  the  painting  as  the  basis  for  mixing 
paints.  For  a  simulation  of  tempera  painting.  the  artist 
should  specify  the  subtractive  color  mixing  method*  since 
tempera  paints  are  opaque  pigments  that  absorb  (i.e.  sub¬ 
tract)  light.  The  color-mixing  algorithm  the  program  em¬ 
ploys  blends  colors  to  produce  the  same  color  as  would 
result  if  real  paints  were  mixed. 

The  artist  switches  between  the  "palette"  mode  and  the 
"painting"  mode  by  pressing  the  ENTER  button  on  the  track¬ 
ball  twice.  When  the  program  reads  the  same  position  twice 
in  a  row*  it  takes  this  as  an  indication  that  a  mode  change 
is  desired. 

While  in  the  "palette"  mode*  use  the  trackball  in  this  way: 
turn  the  TRACK  switch  on  the  trackball  OFF.  To  select  a 
color*  superimpose  the  cursor  on  the  desired  color  and  press 
the  ENTER  button  once.  To  select  a  control  option  (one  of 
the  four  boxes  with  writing)*  position  the  cursor  inside  the 
box  you  are  choosing*  and  press  the  ENTER  button  once. 

While  in  the  "painting"  mode*  the  ends  (width)  of  the 
"paintbrush"  are  defined  by  the  positions  of  the  two  cur¬ 
sors.  To  adjust  width  of  brush*  turn  TRACK  switch  off. 
Turn  either  of  the  two  cursors  off  (they  are  controlled  by 
the  toggle  switches  labeled  "1"  and  "2"  on  the  trackball.  ) 
Move  trackball  to  reposition  the  cursors,  and  then  turn  the 
cursors  back  on.  To  adjust  the  position  of  the  brush  (to 
move  the  brush  wi thout  painting):  turn  TRACK  switch  off. 
Spin  the  trackball  to  move  the  "brush"  to  desired  place. 
Turn  TRACK  switch  on.  Moving  the  trackball  now  will  start 
painting  at  the  cursors. 

AUTHOR 

Marshall  Schaffer. 
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FILES 

Source  program:  cartridge  #16  —  /a/class/marshal,  a 
temporary  file  will  be  created  under  present  working  direc¬ 
tory  (=*pwd):  "pwd "/quarter 

SEE  ALSO 

gr(IV) 

DIAGNOSTICS 

none 


i  A 


THRESH 
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NAME 

thresh  -  Interactive  threshold  program 
DESCRIPTION 

Using  the  TRACK  ball  unit  the  user  can  select  the  most  pleasing 
threshold  of  an  image  with  this  program.  The  horizontal  screen 
position  of  cursor  #1  is  used  to  select  the  current  threshold.  By 
moving  this  cursor  to  the  left  or  right  the  threshold  will  move 
down  or  up  the  grayscale  accordingly.  The  keyboard  <RUBOUT>  key 
will  terminate  the  program. 

USAGE 

thresh  CCbl  wl 

b  —  value  to  use  for  'black'  (0  is  default) 
w  —  value  to  use  for  'white'  (4095  is  default) 


EXAMPLE 
&  thresh 

-Ccursor  moved  to  most  pleasing  threshold!- 
<RUBOUT> 

Eight  bit  thresho 1 d  *  XXXX 
SLLi  felt  ilUJLElLald  -  XXXX 


AUTHOR 
Russ  Smith 
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NAME 

title  -  type  text  onto  the  Grinnell  using  fonts 
SYNOPSIS 

title  <fontname>  C-l 
DESCRIPTION 

Title  allows  you  to  type  on  the  screen  of  the  Grinnell  using 
a  font  which  is  stored  in  standard  Unix  font  file  format. 
The  initial  font  to  use  is  specified  by  the  argument.  If  the 
file  is  not  found>  title  appends  ''.fnt''  to  the  name  and 
looks  again.  If  this  doesn't  work  the  system  font  library 
is  searched.  The  color  used  is  initially  set  to  white.  The 
font  may  be  changed  at  any  time  by  typing  control-C  and 
answering  the  prompt.  The  color  may  be  changed  in  the  same 
manner  by  typing  control-P. 

Placement  of  the  characters  is  controlled  by  cursor  #1  which 
may  be  moved  with  the  track  ball/  or  the  four  arrow  keys 
surrounding  the  *  *  home ' '  key  on  the  Datamedia  keyboards. 
The  position  of  the  cursor  is  updated  after  each  character# 
according  to  the  character's  width.  A  carriage-return  moves 
the  cursor  to  the  beginning  of  the  next  line.  Title  normal¬ 
ly  puts  the  cursor  somewhere  in  the  upper  left  hand  corner 
of  the  screen  when  it  starts;  the  exact  position  depends  on 
the  size  of  the  font.  The  optional  argument  causes 

title  to  leave  the  cursor  wherever  it  finds  it. 

ASCII  control  characters  that  have  printing  characters  de¬ 
fined  for  them  in  the  font  may  be  typed  directly  if  title 
doesn't  interpret  them  specially.  They  can  also  be  entered 
by  preceding  the  equivalent  printing  character  with  a  per¬ 
cent  sign.  (i.  e.  .  ''%a''  for  control-A.  )  To  enter  a  single 
percent  sign«  type  two  of  them. 

The  program  may  be  exited  by  typing  break#  control-D#  or 
rubout. 

AUTHOR 

Lee  Moore.  Modified  by  Fred  Blonder. 

FILES 

*. fnt  -  font  file 

/b/fonts  -  system  font  library 

/dev/gr  -  Grinnell 

SEE  ALSO 

font(III)#  font(V).  pgp ( I  )>  biglet(I),  descfnt(I) 

DIAGNOSTICS 

You  will  be  told  if  title  can't  access  the  font  file  you 
specify#  or  if  you  type  a  character  that  is  not  defined  in 
that  particular  font. 
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BUGS 

Some  fonts  don't  pot  the  cursor  in  the  expected  position. 

The  overlay  cannot  be  used  directly. 

Space  and  tab  may  generate  unexpected  cursor  movements  or 
display  characters.  In  particular*  typing  space  may  place 
the  cursor  at  the  left  hand  margin.  Thus*  only  the 
"arrow"  keys  may  be  used  for  cursor  placement. 
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NAME 

tprint  -  Print  out  a  thresholded  display 


DESCRIPTION 

Tor int  is  used  to  make  a  hard  copy  of  the  displayed  image  after 
it  has  been  thresholded  (i.e.>  through  the  lookup  table)  or  of 
the  overlay  for  the  PRINTRONIX  line  printer.  Depending  on  the 
number  of  arguments  the  resulting  print  will  be  of  the  threshold¬ 
ed  image>  the  complement  of  the  thresholded  image  or  the  comple¬ 
ment  of  the  overlay.  Only  the  overlay  may  be  printed  without 
thresholding!  the  results  being  undefined  for  a  non-thresholded 
image  (see  h£).  The  output  may  be  piped. 


USAGE 

tprint  Ca  Call  >  /dev/lp 
tprint  Ca  Call  !  opr 

no  arguments  -  print  thresholded  image 

1  argument  -  print  complement  of  thresholded  image 

2  arguments  -  print  complement  of  overlay 


EXAMPLE 
/£,  thresh 

{Interactive  thresholding  of  image  takes  place! 
<RUBOUT> 

&  tprint  !  opr 

{Thresholded  image  printed  on  PRINTRONIX! 

7. 


AUTHOR 
Russ  Smith 
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NAME 

track  -  tracks  regions  in  Grinnell  pictures. 

SYNOPSIS 

track 

DESCRIPTION 

Trac k  traces  the  borders  of  thresholded  regions  in  a  Grin¬ 
nell  image.  The  component  to  be  tracked  is  selected  manual¬ 
ly  by  positioning  cursor  1  inside  a  region  and  typing  a 
threshold  value.  Trac  k  scans  right  from  the  cursor  position 
until  a  below  threshold  point  is  found.  Tracking  begins  at 
this  point  and  continues  counterclockwise  around  the  boun¬ 
dary  of  the  region.  Border  points  are  written  to  the  Grin¬ 
nell  overlay  so  tracking  may  be  followed  visually.  As  many 
borders  as  desired  may  be  tracked  by  repositioning  the  cur¬ 
sor  and  entering  a  threshold.  Each  border  tracked  outputs  a 
string  of  integers  seperated  by  blanks.  The  first  two  in¬ 
tegers  are  the  X  Y  coordinates  of  the  starting  point.  Fol¬ 
lowing  the  start  point  is  the  four-neighbor  chain  code  for 
the  border.  A  -1  terminates  the  string  for  each  border. 
Entering  a  negative  threshold  terminates  track  and  causes  an 
additional  -1  to  be  printed  as  an  end  marker.  The  chain 
code  directions  are  shown  in  the  diagram  below. 
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FILES 

/dev/gr 

AUTHOR 

Wallace  S.  Rutkowski 

BUGS 

The  cursor  must  be  positioned  at  a  point  whose  gray  level  is 
at  or  above  the  threshold. 
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NAME 

tv  -  Turn  on  video  digitizer 

DESCRIPTION 

Tv  is  used  to  turn  on  and  start  input  into  the  GRINNELL  memory 
from  the  video  digitizer.  In  usual  practice  the  digitizer's  input 
comes  from  the  T.  V.  c amera>  but  video  disk  and  tape  units  can 
also  be  used  as  input  devices.  Tv  mill  continue  inputting  data 
at  the  standard  frame  rate  <30  frames/second )  until  freeze  is 
used.  Because  ty,  configures  the  GRINNELL  hardware  registers  in  a 
certain  way>  it  should  always  be  followed  by  a  freeze. 

USAGE 

tv 

EXAMPLE 
&  tv 

■CInput  from  t.  v.  camera ,  tape  or  disk} 

£  freeze 

{Freeze  the  current  frame} 

& 


AUTHOR 
Russ  Smith 
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NAME 

vex  -  Random  color  vector  generator  (demonstration  program) 

DESCRIPTION 

Ve x  is  a  demonstration  program  which  will  generate  randomly 
oriented  and  colored  vectors  (or  solid  rectangles)  on  the  GRIN- 
NELL  display.  The  endpoints  and  the  colors  of  the  vectors  are 
determined  using  the  system  random  number  generator. 

USAGE 

vex  Cr3 

r  —  generate  rectangles,  not  vectors 

EXAMPLE 

£  vex  &  vex  r  & 

This  user  is  running  both  versions  of  the  vex  program  simultane¬ 
ously.  It  makes  an  interesting  display. 

AU  THOR 
Russ  Smith 
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NAME 

bu.  buO<  bu4  -  back  up  magtape 
SYNOPSIS 

bu  C  -spec ial  3  C  -N  3  C  count  3 
DESCRIPTION 

Bu  backs  up  magtape  to  the  file  before  the  current  one.  If 
a  previous  file  exists.  the  tape  is  left  positioned  just 
after  the  end-of-file  (EOF)  or  beginning  of  tape  that  begins 
the  file.  If  the  tape  was  already  at  the  beginning  of  tape/ 
then  by.  prints  an  error  message. 

Alternative  names  for  by.  such  as  bu4  provide  a  different  de¬ 
fault  tape  device  according  to  the  last  digit  of  the  name. 

The  options  either  specify  a  non-default  backup  device  or 
provide  for  multiple  file  backup: 

-special  backs  up  tne  given  special  file  instead  of  default 
'  '  /dev/bu_rmtO  ' '. 

-N  backs  up  magtape  raw  device  ' ' /dev/bu_rmtN ' '  where 

the  one  digit  octal  number  N  gives  the  unit  number 
(default  0).  If  N  is  omitted  4  is  used, 
count  backs  up  over  count  file  marks  instead  of  the  de¬ 
fault  of  one.  A  leading  zero  specifies  an  octal 
number.  If  only  a  zero  is  given,  by.  takes  no  ac¬ 
tion. 

DIAGNOSTICS 

Complains  if  the  beginning  of  tape  is  reached  before  the 
file  count  is  exhausted  or  if  the  tape  drive  is  offline  or 
already  occupied.  If  interrupted,  by,  displays  a  count  of 
files  that  have  been  backed  up  over. 


FILES 

/dev/bu_rmt? 

SEE  ALSO 

tm(IV).  rewind(I) 

AUTHOR 

Robert  L.  Kirby 

BUGS 

The  backing-up  version  of  the  tape  driver  must  be  installed. 
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NAME 

chead  -  change  header  of  a  picture  file. 


SYNOPSIS 

chead  picture  CncI  Cnr]  [size! 


DESCRIPTION 

picture 

nc 

nr 

size 


CXAP  picture 

number  of  columns  in  picture 

number  of  rows  in  picture 

size  of  picture<  where  each  pixel  has 

bits 


(size) 


Chead  changes  the  header  of  a  picture.  The  header  of 
p  ic ture  is  initially  read  and  is  replaced  with  nc ,  nr,  and 
size.  If  an  argument  is  not  specified,  the  corresponding 
parameter  in  the  picture  header  is  unchanged. 

nc  and  nr  must  be  greater  than  zero  and  1  <*  size  <-  5. 


FILES 

/mnt/ph i 1/cxap/prog/chead. c  source  code 

DIAGNOSTICS 

Many,  all  of  which  should  be  se 1 f-exp lanatory . 
AUTHOR 

Philip  A.  Dondes 

SEE  ALSO 

HEADER (VI I ) 


DUGS 
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DOSFA (VI ) 


NAME 

dosfa  -  convert  DOS  formatted  ASCII  to  UNIX  standard  ASCII 


SYNOPSIS 

dosfa 


DESCRIPTION 

Dos fa  is  a  filter  that  converts  DOS  formatted  ASCII  input  to 
UNIX  standard  ASCII  output.  The  format  resembles  that  used 
by  DEC  operating  systems  RT-11/  DOS/BATCH-1 1 .  and  RSX-11. 
After  eliminating  any  parity  bit/  each  carriage  return  (015) 
line  feed  (012)  pair  is  converted  to  a  single  line  feed 
(012).  NULL  (0)  characters  are  also  eliminated.  All  other 
characters  are  passed  through  as  is.  Dosf a  eliminates  the 
unnecessary  carriage  returns  read  by  r d ostao e  from  tapes 
produced  by  DOS. 

DIAGNOSTICS 

none 


FILES 


SEE  ALSO 

rdostape(UI ) ,  tm(IV)<  DEC'S  DOS/BATCH  Handbook 


AUTHOR 

Robert  L.  Kirby 

BUGS 


1 
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DOSFB ( V I ) 


NAME 

dosfb  -  convert  DOS  formatted  binary 

SYNOPSIS 

dosfb 

DESCRIPTION 

Dosfb  is  a  filter  that  converts  DOS  formatted  binary  input 
to  raw  data  output  eliminating  the  formatting  information. 
This  input  format  produced  by  DEC  operating  systems  RT-11, 
DGS/BATCH- 1 1 ,  and  RSX-11  can  be  read  by  rdostapa.  Dostap e 
can  write  in  this  format  to  allow  for  the  accurate  retrieval 
of  raw  data  from  DOS  format  tapes. 

DIAGNOSTICS 

A  new  formatted  record  begins  with  the  first  byte  containing 
1.  Other  bytes  between  records  are  ignored.  The  checksum 
information  is  not  verified.  If  the  final  record  is  incom¬ 
plete.  it  is  dumped  as  is. 

FILES 
SEE  ALSO 

dostape(VI),  r d os  tap e ( VI ) ,  tm(IV>.  DEC'S  DOS/BATCH  Handbook 
AUTHOR 

Robert  L.  Kirby 

3UGS 

Checksum  errors  and  non-zero  inter-record  bytes  should  be 
reported . 


1 
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DOST  APS ( V  I  ; 


NAME 

do 5 rape  -  'urita  DEC  DOS-PIP  Format  Tape 

SYNOPSIS 

doibape  C  -special  3  C  -N  3  C  — n  alias  3  C  -uN  3  C  -oN  3 
C  -fiN  3  E  -a  3  C  -b  3  C  -£N  3  C  -hN  3  C  file  3  ... 

DESCRIPTION 

Dos  tap  e  writes  files  in  DEC'S  DOS/BATCH-11  Peripheral  Inter¬ 
change  Program  (PIP)  magtape  format.  The  format  written  by 
Qostaoe  may  be  read  by  DEC  operating  systems  RT-11, 
DCS/3ATCH— 1 1.  and  RSX-11.  The  output  tape  must  have  been 
p r ep o s i t i cned  using  the  Harvard  non-rewinding  magtape  dev¬ 
ice.  Postage  individually  writes  files  converting  each  name 
into  a  sometimes  abreviated  DOS  equivalent.  If  there  are  no 
file  parameters/  d  o  s  ta  p  e  reads  its  standard  input  using  the 
default  name  "UNIX.  OUT".  Dostap  e  normally  leaves  the  tape 
positioned  just  after  the  file  mark  for  the  last  file  writ¬ 
ten/  in  position  for  a  subsequent  dostape  invocation  or  for 
marking  with  two  additional  file  marks  which  constitute  the 
DOS  end-of-tape  convention. 

Each  DOS-PIP  file  on  magtape  consists  of  a  14  byte  header 
record,  512-byte  data  records,  and  one  file  mark.  The  first 
three  words  of  the  header  consist  of  a  radix-50  encoded  name 
and  extension  using  up  to  6  characters  for  the  name  and  3 
characters  for  the  extension.  Dostape  places  only  the  final 
part  of  each  path  name  into  the  header  omitting  any  previous 
directory  names  and  slashes,  treating  lower  case  a-z  as 
upper  case  A-Z.  From  this,  dostape  uses  the  first  6 
filename  characters  before  the  last  dot(.  >,  if  any,  for  the 
encoded  file  name  and  the  first  three  characters  after  the 
last  dot  as  the  extension.  If  the  final  part  contains  no 
dot,  the  first  three  characters  in  excess  of  the  first  six 
become  the  extension.  The  next  two  bytes  are  the  user  and 
group  owner  numbers,  the  next  word  is  the  protection  code, 
and  the  last  two  words  are  the  Julian  date  based  on  1970 
computed  from  the  file  modify  date.  Logical  records  may  ex¬ 
tend  across  the  512-byte  physical  tape  records.  Dostape 
pads  the  last  physical  record  with  NULLs,  i.  e.  zero  bytes, 
up  to  512  bytes 

Doric ns,  except  aliasing,  apply  to  all  the  following  files 
■cut  may  be  reset  between  files: 

-special  writes  to  given  special  file  instead  of  default 
'  '  / dev/nr w_rmtO' 

— N  write  to  non-rewinding  magtape  raw  device 

'  ' /d  ev/nrw_rmtN  "  inhere  the  octal  number  N  gives 
the  unit  number  (default  0) 

-n  alias  treat  the  next  argument  as  an  alias  in  the  the  next 
header  in  place  of  the  actual  file  name. 

-uN  place  user  ID  N  in  header  I^N  is  omitted,  the 

file  owner  is  used  (default'1. 

clace  user  g-oup  ID  N  in  header.  14  N  is  omitted, 
tne  file  group  owner  is  used  (default). 


A 
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lS-September-1979 


DOSTAPE(VI ) 


oiacs  octal  DOS  protection  code  N  in  header.  If  N 
15  omitted,  use  the  default  0233. 

produce  DOS  formatted  ASCII  output  by  inserting  a 
carriage  return  (015)  before  each  line  feed  (012). 
produce  DOS  binary  unformatted  output  (default) 
that  copies  bytes  as  is.  The  last  record  may  be 
null  padded. 

produce  DOS  formatted  binary  output  using  input 
logical  record  size  N.  If  N  is  omitted,  use  8192 
bytes.  Prefixes  each  logical  record  with  the  for¬ 
mat  word  000001  and  a  record  byte  count  that  in¬ 
cludes  the  prefix  words.  Suffixes  each  record  with 
an  additive  one  byte  checksum  and  NULL  padding  to  a 
word  boundary.  The  final  logical  record  may  be 
foreshortened.  The  padding  does  not  preclude  the 
exact  recovery  of  formatted  binary  data, 
write  one  formatted  binary  header  record  of  length 
N  before  the  other  formatted  binary  records.  This 
record  is  followed  by  zero  padding  to  fill  out  a 
physical  record.  If  N  is  omitted,  no  header  record 
is  written. 

For  example 

dostape  -4  /tmp /very  1 ongname  -a  -gl  / tmp /sh or t.  c .  s 
-h&  -f255  -n  fakename.  pic  /tmp/pic 

writes  three  files  to  device  /d ev/nrw_rmt4.  The  first  un¬ 
formatted  file  is  called  ' ' VERYLO. NGN ' '  in  the  tape  header. 
The  second  formatted  ASCII  file  called  '' SHORT.  S ' '  precedes 
each  line  feed  with  a  carriage  return.  The  third  formatted 
binary  file  called  ' ' FAKENA.  P IC ' '  uses  the  data  in  /tmp/pic 
to  produce  a  6  byte  logical  record  followed  by  255  byte  log¬ 
ical  records  appropriate  to  images  with  6  byte  headers.  The 
last  two  files  use  group  1  instead  of  the  original  file 
group  owner. 

DIAGNOSTICS 

Physcial  data  I/O  errors  generate  appropriate  messages.  Ex¬ 
pansion  troubles  indicate  inadequate  buffer  space.  Illegal 
radix-50  characters  are  converted  to  the  ' ' unused  '  '  charac¬ 
ter  (035). 


-p  N 

—a 

-b 

-fN 

-hN 


FILES 

/dev/nrw_rmt?  (default  output  device) 
unix.  out  (default  tape  header  name) 


SEE  ALSO 

ldostape ( VI ) ,  rd ostap e ( VI ) ,  tm(IV),  DEC'S  DOS/BATCH  Handbook 

AUTHORS 

Russ  Smith 
Robert  L.  Kirby 
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NAME 

eot,  eotO,  eot4  -  advance  magtape  to  end  of  tape  mark 
SYNOPSIS 

eot  C  -special  3  C  -CN3  3  C  count  3 
DESCRIPTION 

Eot  advances  the  tape  to  the  next  software  end  of  tape  mark 
that  consists  of  two  file  marks.  When  using  a  standard  tape 
name,  eot  then  moves  the  tape  backward  to  be  immediately 
after  the  first  of  the  two  marks.  From  this  position  the 
tape  can  be  extended  with  another  file.  Otherwise  the  tape 
remains  positioned  immediately  after  both  marks.  A  count  of 
the  number  of  file  marks  passed  is  displayed. 

Alternative  names  for  eot  such  as  eot4  provide  a  different 
default  tape  device  according  to  the  last  digit  of  the  name. 

The  options  either  specify  a  non-default  device  or  limit  the 
number  of  file  marks  that  may  be  passed: 

-special  advances  the  given  special  file  instead  of  default 
' ' /dev/nrw_rmtO ' No  backup  is  performed  after 
advanc ing. 

— N  advances  the  magtape  raw  device  ' ' /d ev/nrw_rmtN ' ' 

where  the  one  digit  octal  number  N  gives  the  unit 
number  (default  0).  Afterward  the  tape  is  backed 
up  to  between  the  file  marks  using  back  up  device 
' ' /dev/b u_rmtN ' ' .  If  N  is  omitted  4  is  used, 

count  limits  the  number  of  file  marks  passed  while 
searching  for  the  software  end-of-tape.  A  leading 
zero  specifies  an  octal  number.  If  only  a  zero  is 
given,  eot  takes  no  action. 

DIAGNOSTICS 

Complains  if  the  tape  drive  is  offline,  already  occupied,  or 
if  reading  the  first  record  of  any  file  being  passed  gen¬ 
erates  a  hardware  error.  If  interrupted,  eot  displays  a 
count  of  file  marks  to  be  passed  before  stopping. 

FILES 

/dev/nrw_rmt ?  /d  ev/bu_rmt? 

SEE  ALSO 

tm(IV),  bu(I).  skp(I).  rewind(I) 

AUTHOR 

Robert  L.  Kirby 

BUGS 


The  backing-up  version  of  the  tape  driver  must  be  installed 

If  the  first  record  of  any  file  passed  is  longer  than  44544 
bjtes,  a  hardware  record  length  error  occurs 
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NAME 

Idostape  -  list  directory  for  DEC  DQS-PIP  Format  Tape 
SYNOPSIS 

Idostape  C  -special  1  C  -N  1  C  -cN  ]  C  -uN  1  C  -gN,  1 
C  file  ]  ... 

DESCRIPTION 

Ld os tap e  lists  a  directory  for  magtape  in  DEC'S  DOS/BATCH-11 
Peripheral  Interchange  Program  (PIP)  format  starting  at  the 
current  tape  position.  The  format  resembles  that  used  by 
DEC  operating  systems  RT-11,  DOS/BATCH-11,  and  RSX-11.  For 
each  file,  Idostape  converts  the  radix-50  filename  in  the 
header  into  six  ASCII  characters  followed  by  a  dot(.  )  and 
three  characters  for  the  extension.  Alphas  are  converted  to 
lower  case.  The  radix-50  codes  0,  033,  034,  and  035  are 
converted  into  blank<  ),  dash(-),  dot(. ),  and  question 
mark<?)  respectively.  The  extension  is  followed  by  a  user 
identification  code  (UIC)  in  brackets,  the  octal  protection 
code  in  angle  brackets,  and  a  decimal  version  of  the  Julian 
date  based  on  1970. 

The  tape  is  left  positioned  after  the  tape  mark  for  the  last 
file  read  or  immediately  after  the  double  file  mark  at  end- 
of-tape  (EOT). 

The  options  either  specify  a  non-def au 1 t  input  device  or 
limit  the  files  to  be  included  in  the  directory  listing: 

-special  search  the  given  special  file  instead  of  default 
' ' /d  ev/nrw_rmtO ' ' , 

-N  search  non-rewinding  magtape  raw  device 

'  '/dev/nrui_rmtN"  where  the  one  digit  octal  number 
N  gives  the  unit  number  (default  0). 

-cN  only  list  information  for  the  next  N  files. 

-uN  only  print  information  for  files  with  user  ID  N  in 

the  header  skipping  files  with  other  IDs. 

-gN  only  print  information  for  files  with  user  group  ID 

N  in  the  header  skipping  files  with  other  IDs. 


DIAGNOSTICS 

Physical  I/O  data  errors  generate  appropriate  messages. 

FILES 

/dev/nrw-rmt ? 

SEE  ALSO 

dostape(VI),  r d os  tap e ( V I ) ,  tm(IV),  DEC'S  DOS/BATCH  Handbook 
AUTHOR 

Robert  L.  Kirby 


1 
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NAME 

pack  -  packs  an  unpacked  picture. 

SYNOPSIS 

sack  Csub33 

DESCRIPTION 

sub3  if  present)  3  is  subtracted  from  the  input 

picture's  size  before  the  output  picture's  header 
is  written 

PACK  reads  a  picture's  header  from  the  standard  input  file 
and  echoes  it  to  the  standard  output  file.  PACK  then  reads 
the  unpacked  picture  from  the  standard  input  file  one  row  at 
a  time)  packs  the  row  and  writes  it  to  the  standard  output 
file. 


The  input  picture  must  be  comprised  of  two  sections/  a 
header  section  and  a  data  section.  The  header  is  a  six  word 
record  of  which  two  types  exist.  Type  1  specifies  as  a 
picture's  size  the  number  of  bytes  which  comprise  a  pixel) 
whereas  type  2  specifies  the  number  of  bits  a  pixel  is  to 
use.  To  obtain  a  type  1  header/  the  sub3  argument  should  be 
given.  This  subtracts  3  from  the  input  picture's  size, 
which  should  previously  have  been  4  or  5.  and  thereby  effec¬ 
tively  creating  a  picture  with  a  type  1  header.  Note  that 
if  the  input  picture's  size  is  already  1  or  2.  it  is  treated 
as  either  a  binary  or  a  2-bits  per  pixel  picture.  The  fol¬ 
lowing  is  the  description  of  the  header: 


word  0 
word  1 
word  2 
word  3 
word  4 
word  5 


unused. 

#  of  columns  in  picture/ 
unused . 

#  of  rows  in  picture, 
unused) 

size  of  picture,  where  each  pixel  is  represented 
by  1  or  2  bytes,  as  in  type  1>  or  where  each  pixel 
is  represented  by  2A(SIZE-1)  bits,  as  in  the  type 
2.  where  SIZE  is  the  picture's  size.  1<=SI ZE<>5. 


The  data  section  is  a  n  x  m  word  stream  of  integer  pictorial 
data.  where  n  is  the  number  of  rows  and  m  is  the  number  of 
columns  in  the  picture.  3oth  unsigned  and  signed  integer 
representation  may  be  used.  If  we  let  PIXWD  = 
16/ (2's (S I ZE-1  )  ) .  where  SIZE  relates  to  the  type  2  header 
format.  represent  the  number  of  pixels  per  word  in  the 
packed  format,  the  length  of  an  output  row  (in  bytes)  is 
calculated  by  the  C-Language  expression 
<  m/P  I  XWD ) *2 )  +  <  mV.P  I  XWD>0?1 :  0  > . 


The  number  of  columns  an  input  row  may  have  is  MAXLEN.  where 
MAXLEN  is  currently  512. 
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FILES 


DIAGNOSTICS 

“Header  not  read" 

"Picture  width  too  large" 

"Illegal  size" 

"Too  much  data>  row  count  expired" 
"Unexpected  EOF  encountered" 
"Input  pipe  not  empty" 


first  12  bytes  of  picture 
not  read 

#  of  columns  exceeds  MAX- 
LEN 

SIZEOO  or  SIZE>=5 

#  of  rows  in  picture  ex¬ 
ceeded 

eof  encountered  before 
picture  completed 
data  still  resides  in  in¬ 
put  pipe 


AUTHOR 

Philip  A,  Dondes 

SEE  ALSO 

UNPACK (VI ) 


3UGS 
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NAME 

rdostape  -  read  DEC  DOS-PIP  Format  Tape 
SYNOPSIS 

rdostap  e  C  -special  1  C  -N  J  C  -sN  1  C  -uN  1  C  -g_N  3 
C  file  3  ... 

DESCRIPTION 

Rdostaoe  reads  files  in  DEC'S  DOS/BATCH-11  Peripheral  Inter¬ 
change  Program  (PIP)  magtape  format.  If  parameters  specify 
a  particular  file  name  or  UIC,  the  tape  is  first  searched 
forward  until  a  suitable  file  header  is  found  or  a  double 
file  mark  (EOT)  is  reached.  If  the  appropriate  file  is 
found)  rd  ostao  e  bypasses  the  header  record  and  passes  the 
remaining  records  to  the  standard  output  as  iS)  regardless 
of  the  length  of  the  records  (up  to  44544  bytes)  or  the  for¬ 
mat  used  to  write  them.  If  no  file  is  specified,  the  file 
at  the  current  tape  position  is  read,  omitting  the  header 
record.  After  a  file  is  transfered,  the  tape  is  left  posi¬ 
tioned  after  the  file  mark  that  ends  the  fils.  If  no  satis¬ 
factory  file  is  found,  the  tape  is  positioned  just  after  the 
double  file  mark  that  defines  end  of  tape  (EOT) 

Rdostaoe  converts  file  names  into  a  sometimes  abreviated  DOS 
equivalent.  The  first  three  words  of  the  DOS-PIP  header 
consist  of  a  radix-50  encoded  name  and  extension  using  up  to 
6  character  for  the  name  and  3  characters  for  the  extension. 
Rdostape  examines  only  the  final  part  of  each  path  name  om¬ 
itting  any  previous  directory  names  and  slashes,  treating 
lower  case  a-z  as  upper  case  A-Z.  From  this,  rdostape  uses 
the  first  6  filename  characters  before  the  last  dot(.  ),  if 
any,  to  compare  with  the  encoded  file  name  and  the  first 
three  characters  after  the  last  dot  as  the  extension.  If 
the  final  part  contains  no  dot,  the  first  three  characters 
in  excess  of  the  first  six  become  the  extension.  The  next 
two  bytes  are  the  user  and  group  owner  numbers.  The  format 
used  may  also  be  read  by  DEC  operating  systems  RT-11, 
DOS/3ATCH-1 1 ,  and  RSX-11. 

The  options  specify  either  a  particular  file  or  non-default 
input  device: 

-special  read  from  given  special  file  instead  of  default 
' ' /  d e v/nrw_rmtO ' ' . 

-N  read  from  non-rewinding  magtape  raw  device 

'  ' /d ev/nrw_rmtN "  where  the  one  digit  octal  number 
N  gives  the  unit  number  (default  0). 

-uN  search  for  user  ID  N  in  header  skipping  files  with 

other  IDs. 

- g N  search  for  user  group  ID  N  in  header  skipping  files 

with  other  IDs 

-sN  seek  past  N  physical  records  before  reading  tape 

If  N  is  zero  or  omitted,  the  first  record  read  will 
be  the  first  in  tne  file  even  if  it  is  the  header 
record  Thus  by  not  specifying  a  particular  file, 
ary  format  data  may  be  read  as  is. 
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DIAGNOSTICS 

Physical  I/O  data  errors  generate  appropriate  messages. 
Illegal  radix-50  characters  are  converted  to  the  ''unused'' 
character  (035). 


FILES 

/d  ev/nrui-rmt? 


SEE  ALSO 

dostape(VI),  ldostape ( VI ) ,  dosfa(VI),  dosfb(VI),  tm(IV), 
DEC'S  DOS/BATCH  Handbook 

AUTHOR 


Robert  L.  Xirby 

BUGS 

Should  be  able  to  output  to  files  other  than  standard  out¬ 
put. 
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NAME 

rewind  -  rewind  magtape 
SYNOPSIS 

rewind  C  special  1  C  N  ]  C  -  ] 


DESCRIPTION 

Rewind  rewinds  magtape  back  to  the  beginning  of  tape. 
Rewind  tries  to  rewind  using  both  the  old  and  new  tape 
dr ivers. 

Alternative  names  for  rewind  such  as  rewind 4  provide  a  dif¬ 
ferent  default  tape  device  according  to  the  last  digit  of 
the  name. 

The  options  specify  a  non-default  backup  devices: 

special  rewinds  the  given  special  file  instead  of  default 
'  ' /d ev/rw_rmtO ' '  and  then  ' ' /d ev/rmtO  '  ' . 

N  backs  up  magtape  raw  device  * ' /d ev/rw_rmtN ' '  where 

the  one  digit  octal  number  N  gives  the  unit  number 
(default  0 ) . 

-  backs  up  magtape  raw  device  '  '  /  d  e  v/rw__rmt4  '  ' . 


DIAGNOSTICS 

Complains  if  the  tape  drive  is  offline  or  already  occupied. 
I/O  errors  from  the  previous  close  are  ignored. 


FILES 

/dev/rw_rmt?  /dev/rmt? 

SEE  ALSO 

tm< IV) ,  b  u ( I ) 

AUTHOR 

Robert  L.  Kirby 

BUGS 


-  1  - 


SKPO, SKP4( I ) 


l-0ctober-1979 


SKPO, SKP4(I) 


NAME 

skp  -  skip  tape  files 

SYNOPSIS 

skoO  #-of-files 
sko4  #-of-files 

DESCRIPTION 

Either  skpO 
skip  over 
fied  on  the 

FILES 

all  the  special  tape  devices  ( /d ev/srmtO,  /dev/srmt4»  etc.  ) 


for  800bpi  tapes  or  skp4  for  1600bpi  tapes  will 
the  number  of  tape  EOF  marks  (i.e.  files)  speci- 
command  line. 


UNPACK (VI ) 


August  1979 


UNPACK (VI ) 


NAME 

unpack  -  unpacks  a  packed  picture. 

SYNOPSIS 

unpack  Cadd33 

DESCRIPTION 

add3  if  present/  3  is  added  to  the  input  picture's  size 

before  the  output  picture's  header  is  written 

UNPACK  reads  a  picture's  header  from  the  standard  input 
file.  adds  3  to  the  picture's  size  if  ad d3  is  present,  and 
writes  it  to  the  standard  output  file.  UNPACK  then  reads 
the  packed  picture  from  the  standard  input  file  one  row  at  a 
time,  unpacks  each  pixel  into  a  word,  and  writes  the  row  to 
the  standard  output  file. 

The  input  picture  must  be  comprised  of  two  sections.  a 
header  section  and  a  data  section.  The  header  is  a  six  word 
record  of  which  two  types  exist.  Type  1  specifies  as  a 
)icture's  size  the  number  of  bytes  which  comprise  a  pixel, 
whereas  type  2  specifies  the  number  of  bits  a  pixel  is  to 
use.  When  unpacking  a  picture  with  a  type  1  header  the  add3 
argument  should  be  given  so  that  3  will  added  to  the 
picture's  size.  This  in  effect  treats  the  input  picture  as 
a  size  4  or  5  picture  and  thereby  treating  each  pixel  as  8 
or  16  bits,  respectively.  The  following  is  the  description 
of  the  header: 

word  0  unused. 

word  1  #  of  columns  in  picture, 

word  2  unused, 

word  3  #  of  rows  in  picture, 

word  4  unused. 

word  5  size  of  picture,  where  each  pixel  is  represented 
by  1  or  2  bytes,  as  in  type  1.  or  where  each  pixel 
is  represented  by  2''(SIZE-1>  bits,  as  in  the  type 
2.  where  SIZE  is  the  picture's  size.  1<=SIZEC=5. 

The  data  section  is  n  rows  of  packed  pictorial  data.  If  we 
let  m  be  the  number  of  columns  in  the  unpacked  picture  for¬ 
mat  and  PIXWD  =  16/(2^ (SIZE- 1 ) ) .  where  SIZE  relates  to  the 
type  2  header  format,  be  the  number  of  pixels  per  word  in 
the  packed  format,  the  length  of  a  packed  row  (in  bytes)  is 
calculated  by  the  C-Language  expression 

( m/P  I XWD  )  *2  >  +  ( m/CP  I  XWD>0  ?1 :  0>.  The  lengths  of  each  input  row 
must  all  be  equal  and  needless  to  say.  the  number  of  rows 
and  columns  in  the  picture  must  be  the  same  as  described  by 
the  picture's  header. 


The  number  of  columns  an  input  row  may  have  is  MAXLEN.  where 
MAXLEN  is  currently  512. 


UNPACK (VI ) 


August  1979 


UNPACK (VI ) 


FILES 


DIAGNOSTICS 

"Header  not  read" 

"Picture  width  too  large" 

"Illegal  size" 

"Too  much  datai  row  count  expired" 
"Unexpected  EOF  encountered" 
"Input  pipe  not  empty" 


first  12  bytes  of  picture 
not  read 

#  of  columns  exceeds  MAX- 
LEN 

SIZEOO  or  SI ZE>=5 

#  of  rows  in  picture  ex¬ 
ceeded 

eof  encountered  before 
picture  completed 
data  still  resides  in  in¬ 
put  pipe 


AUTHOR 

Philip  A.  Dondes 

SEE  ALSO 

PACK (VI ) 


XAPI  N  ■'  V I 


June  1979 


XAP IN (VI > 


NAME 

i3pin  -  read  a  picture  file  from  magnetic  tape 


3YNOPS I 3 

x 3D i n  tape  file  Cfcl  Cfrl  Cncl  Cnrl  Ceil  CriD 


DESCRIPTION 

tape 

file 


f  c 

f  r 
nc 
n  r 
c  1 

r  l 


input  tape  file-  either  9-800  bpi  or  9-1600  Dpi 
(special  tape  files  are  recommended) 

output  disk  file  (will  be  created  if  not  already 
present ) 

first  column  with  which  to  begin  reading  input  pic¬ 
ture 

first  row  with  which  to  begin  reading  input  picture 
number  of  columns  to  read  from  input  picture 
number  of  raws  to  read  from  input  picture 
increment  between  columns  (allows  for  sampling  of 
col umns ) 

increment  between  rows  (allows  sampling  of  rows) 


Xap in  reads  a  raw-formatted  picture  from  tape  devices 
/dev/srmt?  or  / d ev/rmt ?.  The  resulting  output  picture  will 
be  located  in  file  in  the  conventional  CXAP  Format. 


All  arguments  which  are  not  given  are  defaulted.  fc_.  f r , 
c  i .  and  r_^  are  defaulted  to  1.  n£  is  set  the  length  of  the 
first  picture  row  on  the  input  tape  if  left  defaulted  It  is 
crucial  that  all  records  on  the  input  tape  be  the  same 
length  because  no  checking  is  performed  to  ensure  this  nr 
is  defaulted  to  1024. 


Each  pixel  will  be  read  from  the  input  tape  as  one  byte  of 
information  and  converted  to  integer  as  defined  by  C  The 
picture  byte  size  will  be  4-  indicating  8  bits  per  pixel 

If  the  default  or  user  supplied  values  for  nc.  and  nr.  exceed 
the  user  window,  they  are  changed  to  reflect  the  actual  size 
of  the  input  picture. 

All  end-of-file  marks  terminate  xap  in  normally-  with  some 
parameters  (as  mentioned  above)  being  modified  as  needed 
Errors  terminate  xap in  abnormally  resulting  in  the  output  of 
an  error  message  and  the  status  of  the  last  executed  func¬ 
tion  call 


F I LE3 

- mn t /p h i 1 / c xap /prog / xap in. c  source  code 

/•mnt/ohi  1/cxap/prog/ioinf o.  c  inputs  information  for 

program 


D I  A>iNC3T  ICS 

Many-  all  of  which  should  be  self-explanatory. 


XAP IN ( VI  ) 


June  1979 


XAP  I N  ( V I  ) 


AUTHOR 

Philip  A.  Dondes 
5EE  ALSO 

cxap  < vi r ) 

IOINFO (VII ? 

3UGS 


XAPOUT (VI  ) 


June  1979 


XAPOUT (VI ) 


NAME 

xapout  -  write  a  picture  to  magnetic  tape 
SYNOPSIS 

xaoout  file  tape  Cfc3  CfrD  Cnc3  Cnr3  Cshift] 

DESCRIPTION 

file  CXAP  picture  file  to  be  written  to  tape 
tape  output  tape  file,  either  9-800  bpi  or  9-1600  bpi 

(special  tape  files  are  recommended) 
fc  first  column  with  which  to  begin  reading  input  pic¬ 

ture 

fr  first  row  with  which  to  begin  reading  input  picture 

nc  number  of  columns  to  read  from  input  picture 

nr  number  of  rows  to  read  from  input  picture 

shift  each  pixel  is  shifted  2^shift  amount  before  being 
written 

Xaoout  writes  a  CXAP  picture  from  disk  to  either  tape  device 
/dev/srmt?  or  /dev/rmt?. 

All  arguments  which  are  not  given  are  defaulted.  fc.  and  fr. 
are  defaulted  to  1.  nc.  and  nr  are  defaulted  to  the  actual 
dimensions  of  the  input  picture.  sh  if t  is  zero  if  not 
specified. 

Each  pixel  in  file  is  written  as  one  byte  of  information  if 
the  size  of  the  picture  associated  with  file  is  not  equal  to 
5.  Otherwise,  two  bytes  will  be  written  for  each  pixel. 

FILES 

/mnt/ph i 1/c xap /prog/ xap out. c  source  code 

/mnt/phi 1/cxap/prog/ioinfo.  c  inputs  information  for 

program 

DIAGNOSTICS 

Many,  all  of  which  should  be  sel f-exp lanatory. 

AUTHOR 

Philip  A.  Dondes 

SEE  ALSO 

CXAP (VII) 

IOINFO (VII) 


BUGS 


s 


QUADTREES ( V ) 


July  1979 


QUADTREES(V) 


NAME 

quadtrees  -  description  of  quadtree  structure 
DESCRIPTION 

A  set  of  programs  is  available  to  create*  display  and  com¬ 
pute  certain  properties  of  "quadtrees"  representing  64  x  64 
GAP  pictures.  Quadtrees  handled  by  these  programs  are  com¬ 
pletely  "portable"i  i.  e.  they  can  be  passed  around  the  sys¬ 
tem  in  the  same  way  as  files.  New  operations  on  quadtrees 
can  be  programmed  easily  by  keeping  to  the  basic  data  struc¬ 
ture  described  below  and  using  some  of  the  routines  provid¬ 
ed. 

A  quadtree  consists  of  linked  nodes*  where  each  node 
represents  a  quadrant  of  a  binary  image  which  is  either 
black*  white*  or  “gray".  A  node  corresponding  to  a  gray  qua¬ 
drant  has  four  son  nodes.  This  kind  of  structure  can  be 
represented  by  a  linked  list  of  cells*  each  corresponding  to 
a  node  in  the  tree. 

The  cell  format  used  here  is  as  follows  :  Word  0  contains 
the  average  gray  level  of  the  quadrant.  Thus  a  value  0  or  63 
in  this  word  indicates  that  this  is  a  terminal  or  "leaf" 
node  (all  black  or  white)  and  has  no  sons.  Word  1  contains 
the  level  of  the  node  in  the  tree*  the  root  being  level  0. 
Word  2  contains  a  pointer  to  the  "father"  of  the  node. 
Pointers  are  addresses  in  the  machine's  memory  corresponding 
to  Word  0  of  the  node  cell.  In  the  case  of  the  root*  this 
pointer  points  to  Word  0  of  the  root  cell. In  the  case  of  a 
gray  node*  Words  3-6  contain  a  pointer  to  each  of  the  4  sons 
of  this  node.  The  order  of  the  sons  is  NW  *  NE  *  SE  .  SW.  In 
the  case  of  leaf  nodes*  these  words  are  zero. 

If  the  quadtree  is  to  be  roped*  the  node  cell  size  is  in¬ 
creased  by  8*  and  these  additional  words  contain  pointers  to 
the  8  neighbors  of  the  node.  Neighbors  are  only  defined  for 
black  nodes.  If  N  is  a  black  node*  a  neighbor  of  N  is  de¬ 
fined  as  another  black  node  which  lies  adjacent  to  it  and 
touches  one  of  its  corners.  Neighbor  1  of  N>  for  example*  is 
a  black  node  which  is  adjacent  to  the  North  side  of  N  and 
which  touches  its  NW  corner.  Neighbor  2  is  a  black  node 
which  is  adjacent  to  N  's  North  side  and  which  touches  its 

NE  corner . neighbor  8  is  a  black  node  which  is  adjacent 

to  N's  West  side  and  which  touches  its  NW  corner.  When  no 
neighbor  exists  the  corresponding  pointer  is  set  to  -1. 

Each  quadtree  file  contains  a  fixed  header  of  S  words.  Word 
1  contains  the  number  of  disc  blocks  required  by  the  tree 
file.  Words  2  and  3  contain  the  values  of  the  black  and 
white  gray  levels  respectively.  These  are  defaulted  to  0  and 
63  <  but  can  easily  be  changed  to  compress  the  gray  level 
range.  Such  a  compression  would  have  the  effect  of  causing 
nodes  which  are  'mostly'  black  to  be  regarded  as  black  and 
those  which  are  mostly  white  to  be  regarded  as  white.  Word  4 
contains  the  size  of  each  cell  in  the  tree.  Word  5  is 
unused  at  present. 


QUADTREES ( V ) 


July  1979 


QUADTREES <V> 


AUTHOR 

Sanjay  Ranade 
SEE  ALSO 

GAP ( V I ) <  QMAKE < V ) »  QD I SP ( V )  etc. 

BUGS 

If  the  image  is  noisy/  the  size  of  the  quadtree  mill  be 
large.  If  this  size  exceeds  about  12K/  no  tree  will  be  made. 
Unfortunately/  at  the  moment/  trees  are  not  optimally  con¬ 
structed  and  each  node  requires  the  same  amount  of  space. 
Alternative  definitions  of  a  neighbor  are  possible  but  have 
not  been  implemented. 


GROPE (VI ) 


June  1979 


GROPE (VI) 


NAME 

qrope  -  rope  a  quadtree 

SYNOPSIS 

grope  tree 

DESCRIPTION 

tree  quadtree  file  created  with  the  'r '  option  by 
VI 

grope  ropes  a  quadtree  created  by  GMAKE.  Black  leaf 
now  contain  pointers  to  their  adjacent  neighbor  nodes. 

FILES 

DIAGNOSTICS 

a  feuii  all  are  clear  and  se  1  f — ex  p  lanatory . 

AUTHOR 

Sanjay  Ranade 

SEE  ALSO 

quadtrees  (V) 

BUGS 


GMAKE 

nodes 


NAME 


qp  -  profile  a  quadtree 

SYNOPSIS 

oo  tree 

DESCRIPTION 

tree  quadtree  file 


flJL  prints  out  the  number  of  b lac k> wh i te. gray  and  marked 
nodes  in  the  tree  and  the  storage  required  by  each  type. 
Marked  nodes  are  nodes  which  have  been  been  selected  by  some 
other  program  on  the  basis  of  a  particular  property  which 
they  possess  (e. g.  maximal  nodes). 

FILES 

DIAGNOSTICS 

a  few.  all  are  clear  and  se 1 f-e x p lanatory . 


AUTHOR 

Sanjay  Ranade 


SEE  ALSO 

quadtrees  (V) 


BUGS 


QCG (VI) 


June  1979 


GCG<VI ) 


NAME 


qcg  -  find  centroid  of  shape  represented  by  quadtree 


SYNOPSIS 

oca  tree  Cbg] 

DESCRIPTION 

tree  quadtree  file  created  by  QMAKE(VI) 
b  flag  to  specify  inside  approx imation  to  shape 

g  flag  to  specify  outside  approximation  to  shape 

oca  finds  the  centroids  of  successive  approx imations  to  the 
shape  represented  by  the  quadtree.  The  'b'  option  specifies 
that  black  nodes  up  to  a  particular  level  be  used  for  the 
approximations.  The  'g '  option  specifies  black  nodes  up  to  a 
particular  level  and  gray  nodes  at  that  level. 


FILES 

DIAGNOSTICS 

a  feu.  all  are  clear  and  self-explanatory. 


AUTHOR 

Sanjay  Ranade 

SEE  ALSO 

quadtrees  (V) 

BUGS 


Gcmvi  > 


June  1979 


GCM< VI ) 


NAME 

qcm  -  find  central  moments  of  a  shape  represented  by  a  quad¬ 
tree 


SYNOPSIS 

ocm  tree  Cbgl  I  J 


DESCRIPTION 

tree  quadtree  file  created  option  by  QMAKE  VI 
b  flag  to  specify  inside  ap pr ox imat i on  to  shape 

g  flag  to  specify  outside  approximation  to  shape 

I/V  specifies  particular  central  moment  to  be  found 


acm  finds  the  I» J  central  moment  of  successive  approxima¬ 
tions  to  the  shape  represented  by  the  quadtree.  The  'b'  op¬ 
tion  specifies  that  black  nodes  up  to  a  particular  level  be 
used  for  the  approximations.  The  'g'  option  specifies  black 
nodes  up  to  a  particular  level  and  gray  nodes  at  that  level. 


FILES 

DIAGNOSTICS 

a  few.  all  are  clear  and  self-exp lanatory . 
AUTHOR 

Sanjay  Ranade 
SEE  ALSO 

quadtrees  (V).  CM  (VI) 


BUGS 


I 


QDISP (VI )  June  1979  QDISP(VI) 


NAME 

qdisp  -  displays  a  quadtree  on  the  Grinnell  display 
SYNOPSIS 

qdisp  tree  x  y  Cm]  j 

I 

i 

quadtree  file  i 

integers  specifying  the  base  of  the  64  x  64  Grinnell  i 

window  in  which  the  quadtree  is  to  be  displayed.  j 

optional.  If  specified.  only  the  marked  nodes  will 
be  displayed. 

qd iso  displays  the  black  nodes  of  a  quadtree.  The  optional 
argument  m  is  specified  to  display  marked  nodes  only.  This 
is  useful  for  examining  maximal  nodes>  nodes  at  particular 
levels*  etc. 

FILES 

/dev/gr 

DIAGNOSTICS 

a  few.  all  are  clear  and  self-explanatory. 

AUTHOR 

Sanjay  Ranade 

SEE  ALSO 

quadtrees  (V) 


DESCRIPTION 
tree 
x.  y 

m 


sues 


Qcomvn 


June  1979 


QCOM<VI ) 


NAME 

qcom  -  complement  a  quadtree 

SYNOPSIS 

acorn  treel  tree2 

DESCRIPTION 

treel  existing  quadtree  file 

tree2  complemented  tree  to  be  created 


ocom  complements  a  quadtree  ,  i. e.  black  nodes  in 
will  be  white  nodes  in  tree2  etc 


FILES 

DIAGNOSTICS 

a  few.  all  are  clear  and  sel f-ex p lanatory. 
AUTHOR 

Sanjay  Ranade 

SEE  ALSO 

quadtrees  (V) 


tree  1 


BUGS 


Tree2  will  have  the  same  roping  as  treel.  This  means  that  if 
subsequent  processing  needs  roping.  tree2  must  be  re-roped. 


QDISPR  <  VI ) 


June  1979 


QDISPR  <  VI > 


NA'-« 

qdispr  -  row  by  row  quadtree  display 
SYNOPSIS 

qdisor  tree  file  Cm] 

output  in 
will  be 


DESCRIPTION 

tree  quadtree  file 

file  file  to  which  the  64  x  64  picture  will  be 
GAP  format 

m  if  specifiedi  only  the  marked  nodes 

displayed. 


qdispr  displays  the  black  nodes  of  a  quadtree.  The  optional 
argument  m  is  specified  to  display  marked  nodes  only.  Useful 
for  examining  maximal  nodes>  etc.  The  picture  is  output  with 
the  GAP  header. 


FILES 

/dev/gr 

DIAGNOSTICS 

a  few.  all  are  clear  and  self-explanatory. 
AUTHOR 

Sanjay  Ranade 

SEE  ALSO 

quadtrees(V) 


BUGS 

The  algorithm  used  does  repeated  tree  traversal  and  is 
therefore  quite  inefficient. 


QDUMP(VI) 


June  1979 


QDUMP (VI ) 


NAME 

qdump  -  dump  specified  number  of  quadtree  node  cells 

SYNOPSIS 

odumo  tree 

DESCRIPTION 

tree  quadtree  file 

ncells  number  of  cells  to  dump 

stcell  the  cell  number  from  which  to  start  the  dump 

odumo  prints  the  address  of  each  node  cell  followed  oy  its 
contents.  The  address  printed  out  is  relative  to  the  start 
address  of  the  root  cell  (i.e.  address  0  ). 

FILES 

DIAGNOSTICS 

a  few»  all  are  clear  and  sel f-exp lanatory. 

AUTHOR 

Sanjay  Ranade 

SEE  ALSO 

quadtrees  (V) 


BUGS 


QMAKE(VI) 


June  1979 


GMAKE(VI) 


NAME 

qmake  -  make  quadtree  from  a  binary  64  x  64  GAP  picture 


SYNOPSIS 

omake  pic  tree  Crbwl 


DESCRIPTION 

pic 

tree 

r 

b 

w 


a  64  x  64  binary  image  in  GAP  format 
quadtree  file  which  mill  be  created 
will  enable  the  tree  to  be  roped 

black  gray  level  value.  If  not  specified.  defaulted 
to  0. 

white  gray  level  value.  If  not  specified.  defaulted 
to  63. 


amake  makes  a  quadtree  from  the  specified  picture  and  prints 
out  the  number  of  white,  black  and  gray  nodes  in  the  tree 
and  the  storage  required  by  it.  The  'r'  option  will  in¬ 
crease  the  size  of  each  node  to  accommodate  roping  informa¬ 
tion. 

FILES 

DIAGNOSTICS 

a  few.  all  are  clear  and  self-explanatory. 

AUTHOR 

Sanjay  Ranade 

SEE  ALSO 

quadtrees(V) 


BUGS 

If  the  image  is  noisy,  the  size  of  the  quadtree  will  be 
large.  If  this  size  exceeds  about  12K.  no  tree  will  be  made. 


1 


QL(VI) 


June  1979 


QL(VI  > 


NAME 

ql  -  mark  all  nodes  of  a  quadtree  which  are  at  the  specified 
level 


SYNOPSIS 

a  1  tree  n 


DESCRIPTION 

tree  quadtree  file 

n  an  integer  in  the  range  0-6 

a  1  marks  all  the  black  nodes  at  level  n  of  the  quadtree.  A 
mark  is  simply  a  flag  set  at  the  node  cell. 


FILES 

DIAGNOSTICS 

a  few.  all  are  clear  and  self-explanatory. 


AUTHOR 

Sanjay  Ranade 

SEE  ALSO 

quadtrees  (V) 

BUGS 


QMAX(VI)  June  1979  GMAX(VI) 


NAME 

qmax  -  mark  maximal  nodes  of  a  quadtree 

SYNOPSIS 

a max  tree  n 

DESCRIPTION 

tree  quadtree  file 

n  an  integer  in  the  range  0-3 

amax  marks  the  maximal  nodes  of  a  quadtree.  If  n  is  speci- 
fied>  the  definition  of  a  maximal  node  is  extended/  so  that 
a  node  is  maximal  if  it  has  no  adjacent  node  n  sizes  greater 
than  it. 

FILES 

DIAGNOSTICS 

a  feu.  all  are  clear  and  self-explanatory. 

AUTHOR 

Sanjay  Ranade 

SEE  ALSO 

quadtrees  (V) 


BUGS 


QOUT(VI) 


June  1979 


QQUT ( VI > 


NAME 

qout  -  collapse  a 

SYNOPSIS 

oout  tree  file 

DESCRIPTION 

tree  quadtree  f 
file  file  conta 

oout  outputs  a  col 
of  the  output  f 
words  of  a  row  con 
corner  of  the  node 
node  in  the  tree. 

FILES 

DIAGNOSTICS 

a  few.  all  are  clear  and  self-explanatory. 

AUTHOR 

Sanjay  Ranade 

SEE  ALSO 

quadtrees  (V) 

BUGS 

The  table  size  is  limited  to  20.  but  can  easily  be  changed 
if  required. 


quadtree 


i  le 

ining  the  collapsed  tree  . 

lapsed  version  of  the  quadtree.  The  format 
ile  is  '  int  fileC203C3D  '  .The  first  two 
tain  the  coordinates  of  the  bottom  left 
The  third  word  contains  the  level  of  the 
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